所有的程序员都是非常好的代码写作者。但我相信，为了成为更好的程序员，你必须提升你的写作技巧

自古以来，人们都在写作。在古埃及时代，我们通过符号来写作。在文艺复兴时代，我们使用字母来写作。而对于我们每一个，几乎都需要在学校学习如何写作，甚至都不需要问「为什么」。而如今，写作这项技似乎已经开始被低估，大部分人都想要去避开它。事实上，你还是要学习如何写作。写评论，写文档，画设计图，做 PPT 陈述等等。不管你喜不喜欢，你都或多或少要接触到。所以为什么不把这件事做得更好呢？

为什么要写作？

写作是一种管理大脑的方式

出于某种原因，我们人类认为知识等于阅读内容。我读过 Rust 的入门指导文章，所以我知道了这项技术。我读过一本关于 TCP / IP 工作原理的书，所以现在我了解了这些内容。但这不是真的。 如果这是真的，我们都会成为超级明星。

真正帮助我们巩固知识的是写作。这就是为什么我相信，**写**代码，跟复制代码片段是完全截然不同的。因为当你真正写它的时候，你巩固了这个知识。

写作是一种学习的方式

如果你想要学习一个新的课题，你可以写一些关于它的内容。当我想学习一门新的编程语言时，我会使用它写一些简短的代码。当我想了解它是怎么运行的，我会研究完之后写成一篇博客。

写作可以帮你识别错误

很多时候我们被要求准备一份设计文档，而我们却在想：「为什么？ 这个设计非常简单，我可以轻松地把它记在脑子里」。这是一个很大的误解，我们都会陷入其中。如果我们真的编写设计文档，我们就会发现我们的「简单」设计有很多问题。 诸如：不一致、缺失细节，或者只是我们的大脑”懒惰”地思考，这些实际上是没有意义的。

怎样才能写得更多

记住：阅读是一种习惯，写作是一种技巧。为了提升你的技巧，你必须要写得更多。写更多内容的一种简单方法是以不同的方式进行设计评审。不要讨厌写作，也不要像做家庭作业一样做这件事，而是尝试带着热情来写作。每次你写了一个设计方案，都要尝试改进一些内容。使它变得更短——并且没有遗漏关键点，使它变得更长——尽可能的覆盖更多用例

写一些关于你的工作的设计方案和文档，是一种能够让你快速进入写作模式的方法。无论如何你都必须这样做，所以为什么不在写作时改进呢？但是，如果你想在工作之外进一步提高写作水平，请考虑开设博客。如果写博客让你感到畏惧，请考虑在社区上回答问题，但重点是提供文本内容，而不是复制粘贴代码片段。

最后一个建议——不要复制粘贴。我指导过的许多程序员只是简单地复制粘贴所有内容。代码片段，函数声明，等等。我知道如何初始化一个 git 仓库，因为我每次都手动完成它。大部分人会选择从 Github 或者搜索引擎复制相关指令。如果你担心这样做会效率低下，请你记住，评判你做得好不好的标准不是你编写了多少代码或完成工作的速度。

不管你喜不喜欢写作，这件事都是不可避免的。如果你想要有 10 倍以上的提升，那你就不得不去写作。写文档，写设计方案，写业务描述等等。你越早提高写作水平，你就能越快成为一名更好的程序员。

最后，如果你对本篇文章有任何意见建议，或者遇到任何技术上的问题，都可以在下面留下你的宝贵评论。感谢你的收看，欢迎关注我和我的专栏，解锁更多最新技术文章 🌹🌹🌹

翻译 — Nov 13, 2023