《代码整洁之道》- Clean Code - Robert C. Martin
原书信息：Clean Code: A Handbook of Agile Software Craftsmanship 作者：Robert C. Martin（Uncle Bob） 译者：韩磊 出版社：人民邮电出版社 页数：404页（扫描版，未完整OCR） 文件大小：15MB 处理状态：done_toc_only（大页数扫描版，OCR时间预计过长）
书籍概要
本书是软件开发领域的经典著作，由”Clean Code”之父Robert C. Martin（Uncle Bob）撰写。核心观点：代码质量与其整洁度成正比。干净的代码在质量上更为可靠，也为后期维护、升级奠定了良好基础。
本书提出了一系列行之有效的整洁代码操作实践，体现为一条条规则（或称”启示”），并辅以来自现实项目的正、反两面范例。只要遵循这些规则，就能编写出干净的代码，从而有效提升代码质量。
核心主题
1. 整洁代码的哲学
- 代码质量与整洁度成正比
- 干净代码更可靠、更易维护
- 整洁代码是最好的设计
2. 有意义的命名
- 变量、函数、类的命名应能揭示其意图
- 避免误导和含糊的命名
- 使用可搜索的名称
3. 函数设计原则
- 函数应该短小，只做一件事
- 每个函数一个抽象级别
- 避免使用标志参数
- 优先使用多态而非条件判断
4. 注释的艺术
- 好注释是对坏代码的补救
- 注释应解释为什么，而非做什么
- 用代码表达意图，减少注释依赖
5. 格式化
- 代码格式影响可读性
- 团队应遵循统一的格式化规范
- 垂直格式：相关代码应相邻排列
6. 对象与数据结构
- 数据抽象：隐藏实现细节
- 反模式：暴露内部数据
- 亨利法则：过程式代码改变数据结构容易，面向对象代码改变行为容易
7. 错误处理
- 使用异常而非返回错误码
- 优先处理错误路径
- 提供异常上下文
- 不要返回null值
8. 单元测试
- TDD（测试驱动开发）
- 每个测试一个概念断言
- 测试代码应与生产代码同样整洁
- FAST原则：快速、独立、可重复、自验证、及时
9. 类的设计
- 单一职责原则（SRP）
- 开闭原则（OCP）
- 里氏替换原则（LSP）
- 接口隔离原则（ISP）
- 依赖倒置原则（DIP）
10. 并发
- 将并发逻辑封装到同步类中
- 避免共享可变状态
- 使用不可变对象
- 优先考虑线程安全集合
11. 重构与极限编程
- 持续重构
- Boy Scout规则：营地总比来时干净
- 极限编程的实践：小版本发布、持续集成
关键规则摘录
- 命名要能揭示意图
- 函数只做一件事
- 函数参数越少越好（零参数最优）
- 使用异常而不是返回错误码
- 代码格式要一致
- 一行代码不超过一定长度（建议80-100字符）
- 注释应该是解释为什么，而不是做什么
- 测试代码和生产代码同等重要
- 类/模块应该由内向外揭示抽象
- 使用异常而非返回码来处理错误
与其他知识的关联
- 《重构》-改善既有代码的设计 — 与重构技术互补
- 《设计模式：可复用面向对象软件的基础》 — GoF设计模式的实际应用
- 《敏捷软件开发》-原则-模式与实践 — 敏捷开发的工程实践基础
- 《程序员的自我修养》-链接、装载与库 — 理解代码构建机制
可行动点
- 团队制定并遵循代码命名规范
- 代码审查时关注函数长度和参数数量
- 建立单元测试文化，优先TDD
- 培养”整洁代码第一”的工程价值观
- 定期重构，践行Boy Scout规则
注意：本书为扫描版PDF，已完成目录提取和元数据记录。如需完整内容，建议使用原始纸质书或购买电子书版本进行阅读。