代码简洁之道——注释
来源:互联网 发布:有话好好说 知乎 编辑:程序博客网 时间:2024/04/29 15:36
只有代码能忠实的告诉你它在做什么事,尽管有时候也需要注释,我们也该花心思减少注释量;
(1)注释不能美化糟糕的代码:与其花时间编写解释你写出的糟糕的代码的注释,不如花时间清洁那堆糟糕的代码;
(2)用代码来阐述:少写注释,尽量直接用代码表达;
(3)好注释:a、法律信息;
b、提供信息的注释;
c、对意图的解释;
d、阐释:对某些晦涩难明的参数或者返回值进行阐释;
e、警示;
f、TODO注释;
g、放大:放大某种看来不合理之物的重要性;
h、公共API中的Javadoc。
(4)坏注释:a、喃喃自语;
b、多余的注释;
c、误导性的注释;
d、循规式注释;
e、日志性注释;
f、废话注释;
g、可怕的废话;
h、能用函数或变量时就别用注释;
i、少用位置标记;
j、括号后面的注释:应该用短小、封装的函数把代码缩短;
k、归属于署名;
l、注释掉的代码:这个深有感触一定要删掉;
m、HTML注释;
n、和本函数没有关系的注释;
o、不明显的关系;
p、信息过多;
q、函数头:应该写一个函数头,而非写一个好的注释。
- 代码简洁之道——注释
- 《简洁代码之道》总结四之简洁的注释
- 代码简洁之道——函数
- 代码简洁之道——格式
- 《代码简洁之道》读书笔记二:注释、格式
- 代码简洁之道
- 代码简洁之道
- 代码简洁之道——有意义的命名
- 9、代码简洁之道——类
- 程序员进阶——代码简洁之道
- 《代码简洁之道》读书笔记之六:并发编程、逐步改进、注释
- 《代码简洁之道》读后感
- 《代码简洁之道》摘要
- 代码编写简洁之道
- JS代码简洁之道
- Java代码简洁之道
- 《代码简洁之道》总结三之简洁的类
- 《代码简洁之道》总结五之简洁的格式
- [数据库]MySQL Hash索引和B-Tree索引的区别
- hibernate session缓存机制
- Ubuntu 14.04 x64 安装 Android SDK
- web socket
- SpringDI
- 代码简洁之道——注释
- 制作简易计算器封装类
- 多年后
- bzoj1680[Usaco2005 Mar]Yogurt factory
- 【剑指offer】面试题16:反转链表
- 制作简易计算器处理过程Servlet
- *p=&a
- LCD 每隔10分钟 自动熄灭 --打开Framebuffer console的时候
- C#入门基础编程(第一章)