第一章 整洁代码
1. 面对历史混乱代码,期限压力,我们不得不在代码优雅和进度间进行妥协
2. 我们总安慰自己,以后会重新构建,使之更整洁,但大多不会发生,Later equals never
3. 混论代码更容易犯错误,不得不花大量时间修复,修复为了赶进度,引入更多混乱。
4. 什么是整洁的代码:
1. 代码逻辑直截了当,2. 减少依赖,3. 完善错误处理 ,4.性能调至最优
5. 童子军军规:让营地比你来时更干净
第二章 有意义的命名
1. 名副其实,类,函数名,变量名应该告诉你他是谁,他为什么存在,应该怎么用,如果名称需要注释补充,那它就名副其实。
2. 避免误导,避免使用错误,有多重意义,易引起误会的词。
3. 要有区分,要以读者能够区分为标准,避免废话。
4. 使用可以读出来的名称
5. 使用可以搜索的名称
6. 避免使用编码,避免映射思维
7. 类名应该是名词或名词短语,方法名应该是动词或动词短语,别扮可爱
8. 每个概念对应一个词,别用双关语
9. 使用解决方案领域的名称,使用源自解决问题领域的名称
10. 添加有意义的语境,不要添加没用的
第三章 函数
1. 短小, 只做一件事,函数语句都在一个抽象层次
2. swicth 语句,确保switch 都埋藏在较低的抽象层级,且用不重复
3. 使用描述性名称,函数参数尽量少,无副作用,尽量避免时序上的耦合
4. 分割指令与询问,使用异常代替返回值
5. 别重复自己
6. 可以先写再打磨它,分解函数,修改名称,消除重复等
第四章 注释
1. 注释不能美化糟糕的代码
2. 用代码来阐述
3. 好注释:
4. 坏注释
第四章 格式
1. 格式很重要,格式关乎沟通,沟通是程序开发的大事,而不是让代码能工作,代码风格影响到可读性和可维护性。