《clean code 》 chap4注释
摘要:
/**这个主题应该是,有意义的命名; 良好的注释习惯; 熟练的源代码控制系统; */ 注释有其天然的问题:代码在变动,在演化。但程序员不能坚持维护注释。4.1 注释不能美化糟糕的代码 【与其花时间编写解释你搞出的糟糕的代码的注释,不如花时间清洁那堆糟糕的代码。】4.2 用代码来阐述 【创建一个描述与注释所言同一事物的函数即可】4.3 好注释 4.3.1 法律信息 4.3.2 提供信息的注释 4.3.3 对意图的解释 4.3.4 阐述 4.3.5 警示 4.3.6 TODO注释 4.3.7 放大 4.3.8 公共API中的javadoc4.4 坏注释4.4.1 喃喃自语【如果只是因为你觉... 阅读全文
posted @ 2013-01-30 15:53 wolflion 阅读(174) 评论(0) 推荐(0) 编辑