第 1章 导言 001
1.1 如何使用本书 004
第 2章 复杂性的本质 007
2.1 复杂性的定义 007
2.2 复杂性的表现 009
2.3 复杂性的原因 012
2.4 复杂性是增量的 014
2.5 结论 015
第3章 能工作的代码是不够的 017
3.1 战术性编程 017
3.2 战略性编程 019
3.3 投资多少？ 020
3.4 初创企业与投资 022
3.5 结论 023
第4章 模块应该深 025
4.1 模块化设计 025
4.2 接口包含哪些内容？ 027
4.3 抽象 028
4.4 深模块 029
4.5 浅模块 031
4.6 类炎 033
4.7 示例：Java和UNIX I/O 033
4.8 结论 035
第5章 信息隐藏（和泄漏） 037
5.1 信息隐藏 037
5.2 信息泄漏 039
5.3 时序分解 040
5.4 示例：HTTP服务器 041
5.5 示例：类过多 042
5.6 示例：HTTP参数处理 043
5.7 示例：HTTP响应中的默认值 045
5.8 类内的信息隐藏 046
5.9 过犹不及 047
5.10 结论 047
第6章 通用模块更深 049
6.1 让类有点通用 049
6.2 示例：为编辑器存储文本 051
6.3 更通用的API 052
6.4 通用性带来更好的信息隐藏 054
6.5 要问自己的问题 055
6.6 将专用性向上推（和向下推） 056
6.7 示例：编辑器撤销机制 057
6.8 消除代码中的特例 060
6.9 结论 061
第7章 不同层，不同抽象 063
7.1 直通方法 064
7.2 接口重复何时可行？ 066
7.3 装饰器 067
7.4 接口与实现 069
7.5 直通变量 070
7.6 结论 073
第8章 降低复杂性 075
8.1 示例：编辑器文本类 076
8.2 示例：配置参数 076
8.3 过犹不及 078
8.4 结论 078
第9章 合并好，还是分开好？ 079
9.1 如果共享信息，则合并 081
9.2 如果可以简化接口，则合并 081
9.3 消除重复，则合并 082
9.4 区分通用代码和专用代码 085
9.5 示例：插入光标和选择区域 086
9.6 示例：单独的日志类 087
9.7 拆分和连接方法 089
9.8 不同意见：《代码整洁之道》 092
9.9 结论 093
第 10章 避免处理异常 095
10.1 为何异常会增加复杂性 095
10.2 异常太多 098
10.3 定义错误不存在 100
10.4 示例：Windows中的文件删除 100
10.5 示例：Java的substring方法 101
10.6 异常屏蔽 103
10.7 异常聚合 104
10.8 就让它崩溃 109
10.9 过犹不及 110
10.10 结论 111
第 11章 设计两次 113
第 12章 为什么要写注释？4个借口 117
12.1 好的代码自己就是文档 118
12.2 我没有时间写注释 119
12.3 注释会过时，会产生误导 120
12.4 我见过的注释都没有价值 121
12.5 写好注释的好处 121
12.6 不同观点：注释就是失败 122
第 13章 注释应描述代码中不明显的内容 125
13.1 选择约定 126
13.2 不要重复代码 127
13.3 低层注释增加精确度 130
13.4 高层注释增强直观性 133
13.5 接口文档 136
13.6 实现注释：做什么和为什么，而不是怎么做 144
13.7 跨模块设计决策 146
13.8 结论 149
13.9 13.5节问题解答 150
第 14章 选择名称 151
14.1 示例：糟糕的名称会导致缺陷 151
14.2 塑造形象 153
14.3 名称应精确 153
14.4 一致地使用名称 157
14.5 避免多余的词 158
14.6 不同意见：Go风格指南 159
14.7 结论 161
第 15章 先编写注释 163
15.1 拖延的注释是糟糕的注释 163
15.2 先编写注释 164
15.3 注释是一种设计工具 165
15.4 早期注释是有趣的注释 166
15.5 早期注释是否昂贵？ 167
15.6 结论 168
第 16章 修改现有代码 169
16.1 持续使用战略性编程 169
16.2 维护注释：让注释靠近代码 171
16.3 注释属于代码，而非提交日志 172
16.4 维护注释：避免重复 173
16.5 维护注释：检查差异 175
16.6 更高层次的注释更容易维护 175
第 17章 一致性 177
17.1 一致性的例子 177
17.2 确保一致性 178
17.3 过犹不及 181
17.4 结论 181
第 18章 代码应显而易见 183
18.1 让代码更显而易见 184
18.2 让代码不显而易见的因素 186
18.3 结论 190
第 19章 软件发展趋势 191
19.1 面向对象编程和继承 191
19.2 敏捷开发 193
19.3 单元测试 194
19.4 测试驱动开发 196
19.5 设计模式 197
19.6 取值方法和设值方法 197
19.7 结论 198
第 20章 性能设计 199
20.1 如何考虑性能 199
20.2 修改前（后）的度量 202
20.3 围绕关键路径进行设计 203
20.4 示例：RAMCloud的Buffer类 204
20.5 结论 210
第 21章 确定什么是重要的 211
21.1 如何确定什么是重要的？ 211
21.2 尽量减少重要的东西 212
21.3 如何强调重要的东西 213
21.4 错误 213
21.5 更广泛的思考 214
第 22章 结论 215
设计原则总结 217
警示信号总结 219
