Linux之父：连你自己都懒得解释，那这就是一堆垃圾！-Toy模板网

这篇具有很好参考价值的文章主要介绍了Linux之父：连你自己都懒得解释，那这就是一堆垃圾！。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

不出意外，Linus又开喷了，这次的激情开麦，源自一部分没有做注释的合并请求：Linux6.3内核收到了一部分合并请求，但这部分合并完全没有注释。

如果你懒得解释为什么存在一个合并，那这个合并从本质上来说就是错误的垃圾，这是每个开发者都应牢记于心的规则。我重复一遍：如果你不能解释清楚这个合并请求，那就不要做，就是这么简单。——Linus Torvalds

注释不仅展现了代码背后的逻辑，让我们在后期维护时能更容易阅读、理解代码，还能将授权许可、版权信息编写进去。此外，注释也有提示作用，如标记为FIXME或TODO的注释往往表示待定的工作等等。

总之，代码注释告诉了我们为什么会写这样的代码。对Linus来说，收到的合并请求缺乏注释，因为没有合理的解释，代码不仅变得毫无意义，还会变得更难读、难维护。所以代码注释很重要，编写合理的代码注释更重要。
编写注释，快看这三不要！

过多的注释会让源文件变得非常混乱，不仅会降低代码的可读性，还难以维护。（这种写大量注释的行为，也很难不让Linus发火。）

很多人会通过注释保存代码演变的历史记录，但这往往是无用功。一个热知识：版本控制系统可以保存历史记录。还有一些过时的、被废弃的、不正确的注释，一经发现就需要尽快更新或删除，不能再让这些废弃注释误导我们了！

对于那些不再使用的旧代码，大家可能下意识会直接注释掉，但直接干脆利落删除掉这些旧代码会更简洁。毕竟后期维护的时候，大家面对这些注释掉的代码只会敬而远之。

通过重构那些烂代码，可以摆脱不必要的注释：

这样才能使注释更简洁、易看。

以下几个注释模式送给大家：

文档注释模式：记录接口，而不是解释代码本身。
脚注注释模式：主要用于描述为什么采用特定方法，短小精悍。通常在无法从代码中推断出此类信息的情况中使用。
警告注释模式：警告开发人员注意某些特殊需求的注释，如：以超级管理员的身份调用函数。警告可能涉及安全或设计缺陷，注释可能包括TODO或FIXME。
签名注释模式：注释中加上开发人员的首字母缩写。在团队中，我们可以更快速地找到相应人员讨论。
编织代码模式：代码和文档结合在一起。需要首先编写文档，然后对该文档进行编码。