《编写可读代码的艺术》读书笔记 (下)
PB15061359 王亚正
接着上次的第四章,下面讲述第五章到最后的观点。
第五章 该写什么样的注释
1.注释不应该应用于粉饰不好的名字,我们完全可以用一个更加自我说明的名字,并且好代码>坏代码+好注释;
2. 为代码中的瑕疵写注释
3. 要通过注释写清楚类之间如何交互,数据如何在整个系统中流动,以及入口点在哪里。
第六章 写出言简意赅的注释
1. 让注释保持紧凑
2、精确的描述函数的行为
3、用输入/输出的例子来说明特别的情况
4、声明代码的意图
第七章 把控制流变得易读
1、if/else代码块的顺序
首先处理正逻辑;先处理简单的、有趣的,异常的,可疑的情况。
2. 避免使用do/while循环
1)函数要有“单一入口,单一出口”的观点已经过时了。
2)为了避免使用do/while循环而重复一段代码(即while循环体内的代码)的做法是愚蠢至极的。
第八章 拆分超长的表达式
第九章 变量与可读性
1. 为提高可读性,减少变量
2. 让你的变量对尽量少的代码可见。
3. 把定义向下移(即尽可能的推迟变量的声明/定义)
第十章 抽取不相关的子问题
第十一章 一次只做一件事
第十二章 把想法变成代码
第十三章 少些代码
1、YAGNI原则(You Aren't Going to Need It)
2、保持小代码库:
1)创建越多越好的工具代码来减少重复代码;
2)减少无用代码或没有用的功能;
3)让整个项目保持分开的子项目状态;
4)总之,要小心代码的重量。让它保持又轻又好。
第十四章 测试与可读性
总的来看,这本书读起来是比较简单的,主要是关注编码的细节,总结了很多提高代码可读性的小技巧,看似都微不足道,但有好多建议如果提前知道的话可以帮助我之前的代码编写,我觉得如果要成为一位优秀的程序员,要想开发出高质量的软件,必须从细处着手,代码的可读性简洁性是必不可少的