代码注释的作用一直以来都被网站建设程序员们广泛讨论。很多人认为注释不是必要的，写注释那是因为代码可读性太差了。

通常，我们阅读软件比编写软件花费的时间要更多。虽然我从未见过任何科学研究能够证明这一点，但是在软件领域，它就好比一个教条或者信念如此的根深蒂固。 正因为编写软件要比阅读软件要容易，因此代码的可读性而显得尤为重要。程序员可以通过一些技术来实现它，其中一点就包括代码注释。

下面就来讨论下避免写代码注释的五大理由：

1. 程序员更加倾向于鼓励”坏“代码。

有一种说法，有代码注释的就是好代码，因此，程序员经常在代码边上写注释，使其看起来更加出色。如果我们把代码注释当做一种信号，那么也许我们正在编写坏代码。每当我们写注释时应该思考如何使代码看清来更加洁净。

2. 花费更多时间来编写和维护

如果注释没有跟随代码的变化而变化，即使是正确的注释也没有用。注释通常作为代码的第二个版本。当为某个函数写注释时我们需要不断的重复自己，这就违反了 DRY(Don’t Repeat Yourself) 原则。花费时间来增加复杂性，软件需求改变了，代码也随之跟着变化。如果我们写注释，这就意味着必须去维护注释。因此，除非是很必须要，否则我们应该拒绝 在注释上花费双倍时间，相反我们可以利用这些时间来提高代码的质量或开发新的特性。

3. 注释不是测试/验证

修改代码可以依赖工具，比如使用编译器、IDEs及单元测试;而注释却不能。注释没有这些工具，你无法依赖工具或者单元测试在正确的地方或者过期后来确保 它们的正确性。一旦你写了注释，没有测试模块来验证它的正确性，一旦这个注释失败了，那么它就永远的失败了。

4. 注释没有代码文档可靠

通常，注释过期后，它们往往与代码失去了连接性。程序员阅读这些注释或许被“欺骗”了。即使不断的更新了代码注释，唯一了解的是这个代码应该是什么以及它 的可读性。举个例子，如果老本问我们如果项目发生了更改，我们从哪能看出？是代码还是注释？——答案当然是代码。

5. 代码注释风格填补了屏幕空间

采用标准化的注释尤为重要，某些注释标准(如同下面)使用了很多行，这就要求你尽可能多的阅读更多代码。