代码整洁之道

Tue, 07 Jul 2015 13:45:37 +0000

[美]Robert C. Martin 《代码整洁之道》阅读笔记

你是个程序员，你想成为更好的程序员。

整洁代码就像绘画一样。整洁的代码如同优美的散文。干净利落的抽象。

简单代码的规则

消除重复和提高表达力。

做有意义的区分，废话都是冗余，使用读得出来的名称，使用可搜索的名称，避免使用编码，避免思维映射，类名，方法名，别扮可爱，每个概念对应一个词，别用双关语，使用解决方案领域名称，使用源自所涉问题领域的名称，添加有意义的语境，不要添加没用的语境。

目的：提高代码可读性。

短小、只做一件事、每个函数一个抽象层级、switch 语句、使用描述性的名称、函数参数、无副作用、分隔指令与询问、使用异常替代返回错误码、别重复自己、结构化编程。

不能美化糟糕的代码
用代码来阐述
阐述
坏注释：喃喃自语、多余、误导性、循规式、日志式、废话、可怕、能用函数或变量就不该用注释、位置标记、括号后面的、归属与署名、注释掉的代码、HTML 注释、非本地信息、信息过多、不明显的联系、函数头、非公共代码中的 Javadoc、范例

保持良好的代码格式，选用一套简单规则并贯彻之。

测试驱动，单元测试。

挑战、防御原则、执行模型、警惕同步方法之间的依赖、保持同步区域微小、很难编写正确的关闭代码、测试线程代码。

注释、环境、函数、名称、测试。