代码整洁之道【书】--04
2015-12-24 17:00
176 查看
注释:
注释的恰当用法是弥补我们在用代码表达意图时遭遇的失败。我们总无法找到不用注释就能表达自我的方法。
不准确的注释要比没注释坏的多。注释不能美化代码。
//TODO注释 程序员认为应该做,但由于某种原因还么有做
//有时候注释还没有比代码描述明确
误导性注释:词不达意
循环式注释:
日志式注释:
废话注释:喋喋不休,毫无新意
可怕的废话: /*the name*/ private string name;
能用函数或变量时就别用注释
总结一点:注释是:少 快 好 省
以上信息来自《代码整洁之道》
注释的恰当用法是弥补我们在用代码表达意图时遭遇的失败。我们总无法找到不用注释就能表达自我的方法。
不准确的注释要比没注释坏的多。注释不能美化代码。
//TODO注释 程序员认为应该做,但由于某种原因还么有做
//有时候注释还没有比代码描述明确
误导性注释:词不达意
循环式注释:
日志式注释:
废话注释:喋喋不休,毫无新意
可怕的废话: /*the name*/ private string name;
能用函数或变量时就别用注释
总结一点:注释是:少 快 好 省
以上信息来自《代码整洁之道》
相关文章推荐
- python 最长公共子序列
- Delta - 轻量级JavaWeb框架使用文档
- 小小黑客从鼠标钩子开始,密码看看看
- 山东省第六届蓝桥杯 ///标题:移动距离//c/c++组
- 二、JAVA 基础复习
- Python
- Spring——jar包详解
- Delphi中调用API函数经验点滴(三)
- Delphi中调用API函数经验点滴(三)
- 山东省第六届蓝桥杯 ///标题:牌型种数//c/c++组
- spring 切面表达式语法
- java中Double类型的运算精度问题
- ASP.NET MVC4/5 - Ajax 防止 CSRF攻击
- Java Map 集合类简介
- 使用git服务器实现生产环境应用服务器代码更新管理的方案
- 如何自动更新-CMD
- 从头认识java-14.4 Java提供的数组的实用功能(1)
- java——opp
- 编程面向过程和对象的区别
- leetcode:223 Rectangle Area-每日编程第三十三题