书籍摘要

核心定位

这本书不是讲某门语言语法，也不是只靠“代码整洁”口号做价值判断的随笔，而是把“什么算好代码”拆成可执行的工程标准。Tom Long把重点放在长期可维护性上：代码不仅要能运行，还要持续稳定、易改动、不重复造轮子，并且能被他人安全理解和复用。

内容主线

全书先建立判断框架，再把框架落实到具体设计与编码决策。开篇先定义代码质量目标与六个支柱，随后讨论抽象分层、API 与实现细节的边界、团队协作中的代码契约，以及错误处理该如何显式表达。它强调的不是某一种“最佳写法”，而是让代码在多人协作、需求变化和时间推移后仍然可靠。

章节内容

第一章先回答“好代码为什么重要”，把可读性、避免意外、难以误用、模块化、可复用、可测试等原则放进同一套质量框架里，并讨论高质量代码是否真的拖慢交付。

第二章转向抽象层，说明函数、类、接口与 API 边界如何帮助隔离实现细节，也提醒读者分层过细同样会带来成本，连 microservices 也被放进这一判断尺度里。

第三章聚焦协作：别人如何理解你的代码、命名与类型如何传达意图、文档与源码各自承担什么职责，以及代码契约、检查与断言怎样减少误用。

第四章讨论错误处理，区分可恢复与不可恢复错误，比较异常、可空返回值、Result/Outcome、Promise/Future 等信号方式，强调不要隐藏错误，也不要忽视编译器警告。

适用读者

适合已经写过一段时间业务代码、开始在意维护成本的开发者，尤其是想从“能写”进阶到“写得稳、写得久”的工程师与技术负责人。若你只想快速学某个框架 API，这本书不算高效；若你常参与评审、重构、接口设计或团队协作，它会更有价值。

总评

《Good Code, Bad Code》强项在于把抽象、契约、错误处理和可维护性放进统一的工程语境里，适合作为建立代码判断力的中层读物。它不追求炫技，而是帮助读者形成一套能迁移到不同语言和项目中的代码质量标准。