优秀的程序员真的不写注释吗？

我在很多地方看到这样一个观点，“请停止写注释，因为只有烂的代码才需要注释。”这个观点非常巧妙，它让我想起了孟子的一句话，“杨氏为我，是无君也；墨氏兼爱，是无父也。无父无君，是禽兽也。”

况且，国内程序员的英语功底你懂的，变量、方法、类、接口、枚举的命名无法做到真正意义上的名如其意。再加上，有些方法的行数多达三四百行，从头看到尾，看得只想捶自己。

没办法，我的解决办法就是，看懂一行就加一行注释，毕竟注释总比代码要容易理解啊。就好像，我们在调用一个不熟悉的 API 时，只要代码的文档说清楚它是干嘛的，我们就可以用，就敢用，至于实现的细节，暂时没有理解也没关系。

差不多花了两个月的时间（非常漫长、非常煎熬）吧，我总算是把项目中核心的代码给研究清楚了。搞清楚之后，那些之前怎么改都改不掉的 bug 也就迎刃而解了。

这也就是为什么，我倡导大家去读源码的一部分原因了，除了学习，读源码是解决 bug 的杀手锏。要读懂源码，注释是必不可少的。不信，你看看 Java 的源码，每个变量、每个方法、每个类，注释都非常详细，详细到你替源码的作者感到心累。

在我看来，Java 源码的作者绝对是这个世界上最优秀的程序员，连他们都写注释，那些声称“请停止写注释”的号召者是不是要啪啪啪地打脸，直到打肿为止。

写出好的、有意义的注释其实是有难度的，就像写代码一样。在追求卓越的路上，代码和注释其实是相辅相成的。注释会让你的代码更易阅读，代码会让你的注释更富有逻辑。

即便是你的代码已经优雅到不需要注释，那只是在你的层面上。对于你的同事，你代码后来的负责者，就不一定了。所见略同的英雄并不会很多，你以为很优雅的代码没准在别人眼里就是一坨垃圾，而你的注释很可能会帮助别人“恍然大悟”，明白代码的意义。乖乖地写注释吧，对你对别人都有好处。

另外，我想说一句，注释就好像是代码的一个蓝图，也或者是对代码的一个总结。在你写代码之前，脑子里肯定要想清楚你要实现什么，怎么实现，把这些作为注释写下来绝对可以帮助你写出更优雅的代码。在代码写完之后，通过注释进行总结，还能对代码进行一些升华，没准还能在总结的过程中想到更好的代码方案。

我还见到有大牛信誓旦旦地说，写注释就好像是给不会游泳的人扔一个救生圈，他永远也学不会游泳。咋眼一看，这句话说得很有道理，对吧大牛们看来，要让一个新人快速成长，最好的办法就是把没有注释的代码扔给他看。

纯属扯淡，恐怕这个新人没入门就放弃了吧已经三十一岁了，不，我已经十八岁了，还不会游泳呢听那些大牛们的鬼话，我就不信，他自己没写过注释。

来源：沉默王二