关注+
星标公众
号
，不错过精彩内容
编排
| strongerHuang
微信公众号 | strongerHuang
如果领导给你一个项目的源码让你阅读，并理解重构代码，但里面一句注释都没有，我想这肯定是之前同事“删库跑路”了。
看一份源码什么很重要？除了各种代码规范之外，还有一个比较重要的就是注释。
注释虽然写起来很痛苦, 但对保证代码可读性至关重要
，下面的将描述如何注释以及在哪儿注释。
一般
使用
//
或
/* */
，只要统一就好。
2.说明
//
或
/* */
都可以，但
//
更
常用，要在如何注释及注释风格上确保统一。
文件注释描述了该文件的内容，如果一个文件只声明，或实现，或测试了一个对象，并且这个对象已经在它的声明处进行了详细的注释，那么就没必要再加上文件注释，除此之外的其他文件都需要文件注释。
如果你对原始作者的文件做了重大修改，请考虑删除原作者信息。
如果一个
.h
文件声明了多个概念, 则文件注释应当对文件的内容做一个大致的说明, 同时说明各概念之间的联系. 一个一到两行的文件注释就足够了, 对于每个概念的详细文档应当放在各个概念中, 而不是文件注释中。
不要在
.h
和
.cc
之间复制注释, 这样
的注释偏离了注释的实际意义。
函数声明处的注释描述函数功能; 定义处的注释描述函数实现。
基本上每个函数声明处前都应当加上注释, 描述函数的功能和用途. 只有在函数的功能简单而明显时才能省略这些注释(例如, 简单的取值和设值函数)。
如果函数的实现过程中用到了很巧妙的方式, 那么在函数定义处应当加上解释性的注释。比如, 你所使用的编程技巧, 实现的大致步骤, 或解释如此实现的理由. 举个例子, 你可以说明为什么函数的前半部分要加锁而后半部分不需要。
不要
从
.h
文件或其他地方的函数声明处直接复制注释. 简要重述函数功能是可以的, 但注释重点要放在如何实现上。
通常变量名本身足以很好说明变量用途， 某些情况下, 也需要额外的注释说明。
根据不同场景、不同修饰符，变量可以分为很多种类，总的来说变量分为全局变量、局部变量。
一般来说局部变量仅限于局部范围，其含义相对简单容易理解，只需要简单注释即可。
