有一个关于程序员的段子，说所有的程序员都讨厌两件事，一是别人不写注释，二是自己写注释。关于写注释，一直有人争论不休，有的人认为写代码必须要写注释，而又的人认为代码就是注释，何必再写一遍？那么今天我们就聊一聊代码中的注释。

写注释

注释——是对文章或者文字材料中的语汇、内容、名词、引用等作出说明，谓之“注释”。通常用在文章或者文字材料的最后面。例如财务报表项目注释、对古代书籍的注释等。

为什么要写注释？注释就是弥补我们在写代码的过程中，代码表达的含义不清或者容易造成混乱的时候才加上的，或者是对于代码可能存在的风险加以说明，论文中的注释主要写什么内容，或者警示函数调用者使用规范等。，

不写注释

注释是指解释字句的文字，也指用文字解释字句。可以是文字符号图片等多种形式。注释，是对书籍或文章的语汇、内容、背景、引文作介绍、评议的文字。[1]为古书注释开始于先秦时期。中国古代分得较细，分别称之为注、释、传。

什么情况下不写注释？先举一个简单的例子：

很明显这种就是多余的注释，这种注释完全就是多余的，除了增加阅读人的难度，毫无任何意义。再比如：

我们直接把这个判断条件封装成一个方法，这个方法名实际上就“等同于”注释了，所以说上面的注释完全可以不用加。

好注释

注释，是对书籍或文章的语汇、内容、背景、引文作介绍、评议的文字。注释，读音：[ zhù shì ]引证解释：1、解释字句的文字。《＜廖仲恺集＞前言》：“文中的外国地名、人名，与现在通用的译名颇不一致，为保持原貌，未。

这些注释是非常好的注释，并且非常的详细。如果你写的代码将来也是要封装成 API 的，建议也要写的非常规范，以方便调用者使用。有返回值的，一定要详细解释好返回值的含义，比如：

注释的意思： [zhùshì] 1.也叫注解。2.用简明文字解释书刊中的字、词、句。3.也叫注文。解释的文字。注释百科解释： 注释，是对书籍或文章的语汇、内容、背景、引文作介绍、评议的文字。为了保障原作者的著作权。

判断一个字节是否是十进制数字。我们注意看返回值的注释，详细写道， true 表示是一个十进制数字，否则返回 false。工作中我见到过很多开发者写的类似返回 bool 值的方法的注释，都类似“是否是一个十进制数字”这样，这样就不是一个好注释，那么到底是 true 代表“是”还是 false 代表“是”呢？是不是容易混淆？

还有，再比如有些方法内的函数调用必须要有严格的调用顺序，这时候注释也是一定要加的，比如：

因为在后续功能扩展的时候，很有可能在其内部添加一些其他的函数调用，并且这个功能并不一定是当初开发这个函数的人继续扩展添加，如果调用顺序发生错误，很可能会出现很多麻烦。

坏注释

有一段非常经典的代码，求平方根倒数:

这段代码的经典之处除了以非常高效的速度算出来平方根的倒数，还因为其中的一句 wtf 的注释，很明显这个 0x5f3759df Magic Number 没人知道是干什么的。（有人通过数学公式推导出了这个魔法数字的由来，链接）。很明显这里的注释明显不足，至少这里要注释上推导过程或者是利用什么数学公式推算的，因为我们并不能保证所有的程序员都有这样的数学功底。

还有一些注释，就是有些开发者喜欢在注释里添加姓名和日期，例如：

说到这里，还要顺便说下一种坏注释，那就是错误的注释。误导性的注释比没注释更可怕。当我们修改一个函数的时候，如果函数的最初的注释和最新的实现不匹配，一定记得要修改一下注释，哪怕是删掉注释，也不要留着误导性的注释。

“注释”是指一字一句来解释文字或者句子的文字。“注释”，读作 zhù shì 造句：1、赵氏家谱注释细密,参订精详。2、《正字通》注释说:屈原作离骚,言遭忧也,今谓诗人为骚人。3、我觉得在代码和注释之间看来看去搞得我。

总的来说，有些注释是必须要有的，而且于己于他都是有利的。不过函数内部的一些注释，最好的注释就是想办法不去写注释，让自己的代码成为最好的注释，一些函数的命名，最好让看代码的人不必进到函数实体内看具体实现就知道大概在干什么，这是最好的；变量命名一定不要有歧义，哪怕长一点，尽量不要用缩写，保证代码的可读性，这样你就可以和别人吹牛了：我写的代码还用加注释？

不过说到底，注释就是辅助其他人来阅读代码用的，辅助提升代码的可读性。提高代码的可读性，是一条漫长的路，初学者可以看一下一些 IT 公司的代码规范，平时也要严格要求自己，让自己的代码更加整洁清晰。