一种程序员认为，如果类、方法、变量定义准确，代码注释显得有点多余。最好的代码注释便是没有注释。
另一种程序员认为，必须写代码注释。
谷歌创始人布林
别以为你可以理解自己写的代码，过了两个星期之后，你可能就不知道代码是不是自己写的。
如果是大略的代码，不加注释情有可原，但是，繁芜的代码那就必须加注释了。
下面w3cschool分享代码注释的5大技巧：
1、代码注释最基本的原则
代码注释一定是注明代码的目的，而不是代码的行为。为何呢?由于通过代码我们就可以清楚行为，多加注释，多此一举。
2、利用空格对齐注释行
为了方便阅读起见，代码注释对齐会更好一些。那么问题来了，是用tab对齐还是用空格键对齐呢?
我们都清楚，tab在不同的编辑器和集成开拓环境中是不一样的，以是选择空格键对齐汇合适一些。
const MAX_ITEMS = 10; // maximum number of packets
const MASK = 0x1F; // mask bit TCP
3、代码少而精
如果说代码注释一定要有，那就就要只管即便做到少而精。有些人代码注释写的跟小说一样，这后果是相称严重的...
4、代码“统帅”段落
一些程序员习气将代码分成多个“段落”，这是非常要好的一个习气。
以上是谷歌创始人之一布林的代码，他没有在简历中写报酬，直接在html源代码注释：办公室要大，挣钱要多，干活要少...
当然，加个代码注释就会锦上添花。比如在段落代码前加个注释。同样地，便是见告自己或者掩护职员代码的意图。
5、代码注释的精髓
不知道有没有小伙伴利用下面这种办法写代码注释，必须要给出大写的“服”!
