注释代码技巧之一

来源:互联网 发布:java工程师证书考试 编辑:程序博客网 时间:2024/04/27 18:10

Comment each level(每个级别的注释有统一的风格)

注释每一个代码块,并且在各个级别的代码块上,要使用统一的注释方法。例如:

对于类,应包含简单的描述、作者以及最近的更改日期
对于方法,应包含目的的描述、功能、参数以及返回值

使用统一的注释规则对于一个团队是非常重要的。当然,更加推荐使用注释的约定和工具(例如,C#的XML或Java的Javadoc),它

们会是注释变得更加容易。

原创粉丝点击