|
1. 逐层注释
为每个代码块添加注释，并在每一层使用统一的注释方法和风格。例如：
针对每个类：包括摘要信息、作者信息、以及最近修改日期等；
针对每个方法：包括用途、功能、参数和返回值等。
在团队工作中，采用标准化的注释尤为重要。当然，使用注释规范和工具(例如C#里的XML，Java里的Javadoc)可以更好的推动注释工作完成得更好。
2. 使用分段注释
如果有多个代码块，而每个代码块完成一个单一任务，则在每个代码块前添加一个注释来向读者说明这段代码的功能。
3. 在代码行后添加注释
如果多行代码的每行都要添加注释，则在每行代码后添加该行的注释，这将很容易理解。
4. 在代码时添加注释
在写代码时就添加注释，这时在你脑海里的是清晰完整的思路。
5. 为自己注释代码
当注释代码时，要考虑到不仅将来维护你代码的开发人员要看，而且你自己也可能要看。用Phil Haack大师的话来说就是：“一旦一行代码显示屏幕上，你也就成了这段代码的维护者”。因此，对于我们写得好(差)的注释而言，我们将是第一个受益者(受害者)。
6. 为自己注释代码
永远比测试多想一步--------争取 无 bug 奇迹 ！ | 
转播
