译者 | Steve Gordon

翻译者 | 没错如月，白眉林 | 屠敏

公司出品 | CSDN（ID：CSDNnews）

下列为原文：

嘿，朋友们！责任编辑我将撷取许多有关积极主动写作和科学研究源标识符的许多设想。事实证明，写作源标识符能帮你正式成为一位更专精的合作开发人员。众所周知的是，写作源标识符提升了我的软件设计水准。

如果写作源标识符吗？

是的，你如果那么做！

好最新消息是，你年复一年软件设计时早已在那么做了。多年来，我看见各式各样统计数字说明，开发人员绝大多数天数都花在了写作标识符上，而非写标识符上。

当你要合作开发两个新功能或是复原两个 BUG 时，你要要先认知原有标识符的方法论。你能透过写作程序代码来介绍标识符的方法论，即使程序代码如果能确切地抒发标识符犯罪行为期许，但一般来说他们却是要深入细致到具体内容的标识符同时实现中去预测。

责任编辑将得出两个所推荐的源标识符写作方式。我在这儿所推荐我们要积极主动写作源标识符，不光是写作这些已为的源标识符。即使和已为的标识符较之，写作他们曾撰写的代码对他们专精技能的提升协助并不大。

体能训练他们更慢地写作和认知源标识符。

为什么要花天数写作源标识符？

让他们先思考孩子是如何学习读写的。在 Caroline Linse 写的《少年学习者》中，她说你能写出两个单词的前提是你之前读过它。事实证明，这听起来很合理。首先透过在上下文中写作到单词，然后你开始认知它们的含义并学会正确地使用。

读书能拓展你的写作量，学到将来可能用在写作中的技巧。这也是他们为什么要在学校里学习文学的原因。最终，随着他们读的越来越多，他们有了辨识能力，知道哪些是更有用。

对软件标识符来说也是如此。我是两个 C# 程序员，但不管你是什么编程语言的合作开发人员，每种编程语言都会有很多语法和关键字。你能将这些简单的关键字和概念可合在一起编码出无限种可能性。有很多方法能同时实现同样的效果，就像有很多方式抒发出同样的含义一样。虽然从技术角度而言，不同的标识符都能同时实现同样的效果，但有些方法却比其他方法更适合。透过写作源标识符，他们会发现，有些方案可能比其他方案更有效。

不知道你有没有遇到过他们的同事甚至他们撰写过难以写作的标识符？反正我有遇到过。难以写作的标识符很难维护，并且会影响合作开发进度。正如在语言中，段落结构不合理很容让人感到困惑，难以理解，标识符也是如此。很多难以认知的段落或标识符需要反复写作才能认知其真正含义或意图。他们能透过写作更多的源标识符提升编码水准，从而避免撰写出难以认知的标识符。

提升专精技能需要刻苦地努力。学习这些比你工作经验更丰富的人的标识符将会给你未来的工作编码带来协助。举个例子，医生透过多年的培训才能拥有行医资格。这些医生最初和经验丰富的老医生一起工作，先观察模仿，然后才能独立工作。顶尖的医生也会积极主动学习他们专精领域的论文，从中学习新的技术和方法。

就上述描述而言，我认为软件设计领域做的不够。有些团队相对做得更好许多。结对编程和 Mob 编程（3 个或 3 个以上程序员一起编程）只是合作开发人员共享专精技能的方式之一。另外两个提升他们专精技能的途径是定期接触新的标识符，并能坚持下去。

在这个问题上我能直言不讳吗？如果你没天数写作，你就没天数写作，就那么简单。

― 史蒂芬·金, 《写作这回事: 斯蒂芬·金创作生涯回忆录》

如果写作哪些源码？

如果你认可我的上述观点，我希望你能接受将写作源标识符当做日常工作的一部分的理念，以便能透过写作源标识符不断提升专精技能。

下两个问题就是你该读哪些源标识符？

从宏观上讲，我认为这个问题不关键，关键的是你有没有去写作源标识符。请记住，并不是所有的软件标识符都生来平等。你写作许多源标识符会明显比写作另外许多源标识符效果更好，但不管好源标识符却是坏源标识符都能协助他们提升编码能力。

这并不是说你要赞同你写作的所有标识符。写作“糟糕”的代码也能给我带来许多启示。如果你在写作许多标识符的过程中发现了他们不喜欢的风格或是读到了没啥用的方法，同样也能节省他们他们的编码天数，即使他们能避免犯同样的错误。

也就是说，你需要写作标识符来补充许多新的、更靠谱的实践方式（下面一节将讲述如何寻找源标识符）。

我把天数花在科学研究我经常使用的 C# 标识符库的源标识符上。透过这种方式，不仅提升了我写作标识符的能力，还帮我更好的介绍库函数的内部工作原理，进一步协助我更好地使用它们，可谓是一箭双雕。

虽然我也不是经常那么做，但我打算尝试写作许多我很少或是从没有用过的编程语言标识符。精通一门编程语言非常有用，但拓展他们的语言范围也有诸多好处。如果你仔细思考下会发现，很多人学习第二种甚至第三种语言，并能从中受益。他们和其他国家的人交流起来会非常容易，而且透过对其他语言的学习，又反过来促进了母语的学习和使用。

学习第二种编程语言不仅能拓宽你的职业选择，而且还能让你注意到它和他们主要编程语言的异同。他们经常看见一种编程语言来预先学习这些特性。

去哪里找优秀的源标识符？

GitHub

这儿几乎拥有所有编程语言的源标识符。那么要从哪里入手呢？我个人更喜欢先学习微软的 ASP.NET Core 和 CoreFx 库。我发现深入细致科学研究框架团队的高质量标识符是两个很好的学习方法。

这些框架是非常好的学习资源，即使它们的标识符的质量很高，而且从中也能瞥见微软编码模式的影子。透过写作和学习团队如何构建可拓展的框架标识符，我个人收获很大。最近我花了许多天数思考任务并行库，在我撰写的许多标识符中发现了很多有关 CancellationTokenSource 的用法。透过学习微软的源标识符，我学到他们相关的常见用法。

GitHub 提供了很好的源标识符搜索功能，你甚至不需要下载标识符就能在浏览器中学习源标识符。如果你想深入细致学习，我更倾向于建议你将源标识符克隆到本地，这样学习起来更方便。

我还喜欢透过写作我使用的库的源标识符如 Polly 和 MediatR 来拓展我能使用的功能。这让我接触到了其他的编程风格，协助我加深对编码的认知。我并不是都喜欢或是赞同所写作的源标识符，但写作源标识符有助于协助我介绍他们的编码习惯。透过写作源标识符，我会更有意识地积极主动避开潜在的陷阱和糟糕的设计。

博客文章

网上有很多软件设计相关的优秀文章。你肯定能找到带有示例标识符的技术博客。即使这些文章的标识符一般来说比较短小，所以更容易在短天数内认知消化。一般来说，博客配套的标识符译者也会得出注释或是解释，你能先对标识符进行预测然后和译者的意图进行比对。

图书

有很多经典的技术图书，包括电子版和纸质版。这两种图书都会包含许多源标识符。去年我就透过写作Konrad Kokosa 写的《深入细致 .net 内存管理》学到了很多撰写高性能标识符的知识。

StackOverFlow

内部资源

前面我讲过，让他们接触之前没见过的标识符对读源标识符至关关键。我想补充的是，你还能透过学习工作标识符库中他们很少参与的项目来提升编码能力。能花点天数去认知这些标识符，搞懂他们的工作原理。如果有一天需要你去支持这些项目，你可能比源译者更熟悉这些标识符。

当你加入两个新的团队时，你能透过学习团队原有的标识符来快速介绍编码规范和常见的模式。这将加快你融入团队的速度，促进你的个人发展。

这不是两个非常详细的清单。不管你在哪里找源标识符，都如果花费更多的天数去深层次写作和学习。用这种方式投入天数来提升合作开发专精技能非常值得。

如何写作源标识符？

有关写作源码，每个人都会有他们的喜好。按照你认为正确的方式去做就好了。在这儿，我会撷取他们的写作源标识符的方法，你能借鉴这些方法开启他们的源标识符写作之旅。

一般来说我会将重点放在这些想学习的编码风格的源标识符或是这些能加深我对编码知识的认知的源标识符上。正如前面我讲到的，这种投资将会得到丰厚的回报。

我一般来说会从 GitHub 上找源标识符。我会集中精力认知标识符的意图。我会尝试从两个高抽象的函数作为出发点，然后逐步深入细致到内部。在学习标识符时，我喜欢用 OneNote 做笔记，记录标识符的流程。这些都是比较简单的笔记。这个过程与其说是在积累参考资料，不如说是帮我加深记忆和认知。透过将源标识符转为书面描述，我的印象更加牢固，对知识点的认知也会更好。

浏览标识符并在心中形成两个方法论图是两个非常棒的专精技能。如果你能在写作源标识符过程中培养出这种能力的话，下次你复原 BUG 时将会更加顺利。

一旦我对源标识符有个两个整体的介绍，我将会更深入细致地科学研究下去。接下来，我会将源标识符克隆到本地并将其导入到 IDE 中。能使用 IDE 的标识符导航功能快速在源标识符中切换，进一步深入细致科学研究源标识符。此时，我会去思考译者这样写标识符的原因是什么。我喜欢先他们去思考，然后和译者的实际标识符进行对比。我会思考：像译者那么写法会更好、更有效？下次如果我也遇到类似的场景，要不要参考他的写法？

在写作源标识符的过程中，我会发现他们编码时从未用到的 API。我发现当我编码时，我会倾向于使用他们已经熟悉的 API，但这可能并不是最佳的同时实现方式。有时候正是即使他们不知道还有其他选择，所以才继续使用早已熟悉的 API。写作源标识符的过程中，如果遇到我从未用过的 API，我会查看它的描述和方法签名来介绍它的用途。

写作源标识符还提升了我使用 IDE 工具的能力。在浏览标识符时，我会发现许多技巧或学会许多实用的快捷键，从而节省了很多天数。我还经常会把两个类拖到第二个显示屏的一块屏幕上，这样能快速跟踪标识符流。我写标识符的时候也会经常那么做。 读源标识符时我也会努力学习他们不熟悉的语言特征或模式。透过写作源标识符我快速掌握了 C# 的新特性。

如果有些标识符认知不了怎么办？

莫慌，这绝对没问题。刚上来，你不可能认知他们读到的所有源标识符。而且有些不认知，这正是他们想要的效果。你就如果读新的标识符或是包含新语法的标识符，来提升他们的编码专精技能。写作容易认知的标识符，就像写作一本非常简单的书一样，对你的协助并并不大。

你如果在大脑中尝试将标识符拆分成小部分。思考这些标识符是为了同时实现什么功能，为什么要那么写？译者是否用了两个方法解决了两个你从未思考过的问题？当你遇到某个语法不认知或是某个关键字不懂时，请停下来搜索协助文档。有了实际的使用场景，再去查协助文档认知就会更好许多。

如果你遇到从未用过的框架 API 时，如果有标识符文档，能查看标识符文档。对于所有的微软库，公共方法都会包含 XML 注释。你能直接写作这些注释也能透过访问.NET API 文档 来查询。

有意识的积极主动写作源标识符的意义在于，这是你你积极主动分配他们的天数，为他们专精技能投资。而不是在工作中面临最后期限，要完成各式各样功能，还要复原各式各样 BUG。这样你将很少有精力去学习他们直接使用的标识符之外的源标识符。这种情况对学习没啥协助。

我从源标识符中学到了什么？

我从源标识符中学到了很多东西，这也是为什么我不遗余力地所推荐我们学习源标识符。现代的手艺人会经常科学研究他们领域大师的作品，以期有朝一日能达到他们的水准。合作开发人员也能像他们一样向他们领域的专家学习来提升他们的专精技能。

就我个人而言，作为两个 .NET 合作开发人员，我发现学习微软的 .NET Core 和 ASP.NET Core 源标识符非常有价值。微软有很多优秀的合作开发人员，他们对语言或运行时特定知识的掌握更加专精。

我是一位自学成才的合作开发人员，最近在 Twitter 上看见有人那么说（不过，我记不住他是谁了）。我透过各式各样尝试和各式各样错误中学习了 C#，并且我会积极主动学习源标识符。正如很多学者们科学研究伟大的文学作品一样，透过写作伟大的标识符，能解锁很多秘密。

我向这些对软件设计感兴趣并且希望深入细致介绍 .NET Core 框架的人所推荐两个资源，该资源能从 Yo人来说用他们的天数去看会议可能有些太过“极客”，但这仍然是两个非常的学习途径。这个团队是由真正专家组成的，他们对语言、运行时和框架了如指掌，让人震惊。透过观看他们对提议的 API 的讨论，能协助他们认知两个广泛使用的框架要考虑的问题。透过观看这些视频，我经常能获得许多非常有价值的观点。

总结

我写这篇文章的主要目的是鼓励许多读者更加积极主动地写作和学习源标识符。透过写作源标识符，我学到了更多 C# 语言和 .NET Core 框架的知识，协助我正式成为一位更优秀的合作开发人员。定期投资几个小时来写作源标识符，将在未来带来丰厚的回报。透过写作源标识符，你将对不同的编码风格和技术有他们的看法。你将从更深的层次上介绍你平时所用的框架的工作原理，反过来又促进你更好的使用它。你将能更慢地写作源标识符，从而协助你缩短从需求到编码完成的天数。

原文：