代码整洁之道-读书笔记

第四章 注释

1. 无法找到不用注释就能表达的方法，所以总要用注释。P50
2. 用代码的可读性替代注释。P50
3. 注释往往是因为糟糕的代码而存在的。P50
4. 多余的注释。P56
5. 忘更新的误导性注释。P58
6. 日志性注释（有版本控制器就不需要）。P59
7. 归属于署名。P63
8. 注释掉的代码。P63

第五章 格式

1. 用一套管理代码格式的简单规则。P71
2. 格式的目的，增强沟通。P72
3. 代码长度200行。P73
4. 向报纸学习，细节渐次增加。P73
5. 行长度120个字符。P80
6. 团队要有规则并遵守。P84

第六章 对象和数据结构

1. 过程式代码（使用数据结构的代码）便于在不改动既有数据结构的前提下添加新函数，面对对象代码便于在不改动既有函数的前提下添加新类。反过来讲，过程式代码难以添加新数据结构，因为必须修改所有函数。面向对象代码难以添加新函数，因为必须修改所有类。P90
2. 德墨忒尔律：模块不应了解它所操作对象的内部情形。P91
3. 对象暴露行为，隐藏数据。P94

第七章 异常处理

1. 使用异常而非返回码。P96
2. 使用不可控异常，一旦一底层函数声明抛出异常， 那么上层函数逐级都要修改。违反开闭原则。P98
3. 根据需要定义异常类。对错误分类的方式有多种，可以依据来源，是组件还是其他地方，或者依据类型，是设备错误还是网络错误。不过在我们定义异常类的时候，最重要的考虑是如何捕获它们。P99
4. 别返回null值。程序中不断的看到检测null值的代码，一处漏掉检测就可能会失控。返回Null，作者认为这种代码很糟糕。建议抛出异常 或者返回特定对象（默认值）。更早的发现问题。同理，也应该避免传递Null值给其他的方法。P101

作者：文浩读书
链接：https://www.jianshu.com/p/b875985e5705
来源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。