https://skyseraph.github.io/tags/cleancode/Recent content in CleanCode on SkySeraphHugozh-CNMon, 06 Oct 2025 08:00:00 +0800https://skyseraph.github.io/posts/2025/clean_code/Mon, 06 Oct 2025 08:00:00 +0800https://skyseraph.github.io/posts/2025/clean_code/<blockquote> <p>作者：SkySeraph<br> 原始链接：<a href="https://skyseraph.github.io/posts/2025/clean_code">《代码整洁之道》</a><br> 日期：2025-10-06<br> 这本书真正的贡献不是&quot;代码要整洁&quot;这个道理，而是提供了一套<strong>可操作的判断框架</strong>：当你在命名一个变量、拆分一个函数、决定是否写注释时，它给了你一个具体的评判标准。它的缺陷同样真实：这套框架是为 Java 企业软件定制的，它把特定语境下的最佳实践包装成了普适真理。读这本书的正确姿势是：把它当作一位有偏见但见识深刻的前辈，认真倾听，批判吸收。</p> </blockquote> <hr> <h2 id="一书籍介绍">一、书籍介绍</h2> <p><strong>基本信息</strong></p> <table> <thead> <tr> <th>项目</th> <th>内容</th> </tr> </thead> <tbody> <tr> <td>书名</td> <td>代码整洁之道</td> </tr> <tr> <td>原著书名</td> <td>Clean Code: A Handbook of Agile Software Craftsmanship</td> </tr> <tr> <td>作者</td> <td>Robert C. Martin（&ldquo;Uncle Bob&rdquo;）</td> </tr> <tr> <td>译者</td> <td>韩磊</td> </tr> <tr> <td>出版社</td> <td>人民邮电出版社（中文版）；Prentice Hall（英文版）</td> </tr> <tr> <td>出版年份</td> <td>2008年（英文版）；2010年（中文版）</td> </tr> <tr> <td>ISBN</td> <td>978-7-115-21687-8（中文版）；978-0-13-235088-4（英文版）</td> </tr> <tr> <td>页数</td> <td>387页</td> </tr> </tbody> </table> <p><strong>作者简介</strong></p> <p>Robert C. Martin 有超过 50 年的编程经验，是《敏捷宣言》的 17 位联合起草人之一，SOLID 原则的命名者和推广者。他创办了 Object Mentor Inc.，在数十年的企业咨询和培训中接触了大量真实的&quot;烂代码&quot;——这是他写这本书的独特资格：他不是纸上谈兵，而是见过代价。他的代表作系列（Clean Code → The Clean Coder → Clean Architecture）构成了一套从代码到职业到系统的完整工程师素养观。</p> <p><strong>内容概览</strong></p> <p>本书的核心主张可以浓缩为一句话：&ldquo;代码首先是写给人读的，其次才是让机器执行的。&ldquo;全书可以分为三层：<strong>规则层</strong>（第1-13章，给出命名、函数、注释、格式、对象、错误处理、测试、类、系统等维度的具体规则）、<strong>实践层</strong>（第14-16章，通过真实代码的完整重构过程展示规则如何落地）、<strong>参考层</strong>（第17章，66条代码坏味道清单，可作为独立的代码审查手册使用）。</p> <p>这本书挑战了三个工程文化中的常见假设：（1）&ldquo;能跑就行&rdquo;——作者论证可读性是长期生产力的基础设施；（2）&ldquo;注释越多越好&rdquo;——作者论证注释是代码表达失败的信号；（3）&ldquo;测试代码可以随便写&rdquo;——作者论证脏测试等于没有测试。</p> <p><strong>相关链接</strong></p> <ul> <li><a href="https://book.douban.com/subject/4199741/">豆瓣读书</a>（评分 8.6，10万+ 评价）</li> <li><a href="https://www.goodreads.com/book/show/3735293-clean-code">Goodreads</a>（评分 4.4/5，20万+ 评价）</li> <li><a href="https://www.amazon.com/Clean-Code-Handbook-Software-Craftsmanship/dp/0132350882">Amazon</a></li> <li><a href="https://cleancoders.com">作者视频课程</a></li> </ul> <hr> <h2 id="二大纲与阅读笔记">二、大纲与阅读笔记</h2> <h3 id="全书结构">全书结构</h3> <table> <thead> <tr> <th>章节</th> <th>标题</th> <th>核心问题</th> <th>本章最重要的一个概念</th> </tr> </thead> <tbody> <tr> <td>第1章</td> <td>整洁代码</td> <td>什么是整洁代码？代价是什么？</td> <td>勒布朗定律：稍后等于永不</td> </tr> <tr> <td>第2章</td> <td>有意义的命名</td> <td>名字如何传达意图？</td> <td>名字长度应与作用域大小成正比</td> </tr> <tr> <td>第3章</td> <td>函数</td> <td>如何写只做一件事的函数？</td> <td>单一抽象层次原则（SLAP）</td> </tr> <tr> <td>第4章</td> <td>注释</td> <td>什么时候应该写注释？</td> <td>好注释解释 why，坏注释解释 what</td> </tr> <tr> <td>第5章</td> <td>格式</td> <td>代码格式如何影响可读性？</td> <td>报纸隐喻：从高层到细节自上而下</td> </tr> <tr> <td>第6章</td> <td>对象和数据结构</td> <td>对象与数据结构的根本区别是什么？</td> <td>过程式 vs OO 的对称反转</td> </tr> <tr> <td>第7章</td> <td>错误处理</td> <td>如何让错误处理不污染业务逻辑？</td> <td>不要返回 null，不要传递 null</td> </tr> <tr> <td>第8章</td> <td>边界</td> <td>如何安全地使用第三方代码？</td> <td>学习性测试（Learning Tests）</td> </tr> <tr> <td>第9章</td> <td>单元测试</td> <td>什么是整洁的测试？</td> <td>F.I.R.S.T. 原则</td> </tr> <tr> <td>第10章</td> <td>类</td> <td>类应该有多大？职责边界在哪里？</td> <td>内聚性下降 = 拆分信号</td> </tr> <tr> <td>第11章</td> <td>系统</td> <td>如何在架构层面保持整洁？</td> <td>构建与使用分离（DI/IoC）</td> </tr> <tr> <td>第12章</td> <td>迭进</td> <td>简单设计的充要条件是什么？</td> <td>Kent Beck 四规则（按优先级）</td> </tr> <tr> <td>第13章</td> <td>并发编程</td> <td>并发为什么难？如何防御？</td> <td>并发代码与业务代码必须分离</td> </tr> <tr> <td>第14-16章</td> <td>案例研究</td> <td>原则如何在真实代码中落地？</td> <td>重构不是一步到位，是持续迭代</td> </tr> <tr> <td>第17章</td> <td>味道与启发</td> <td>如何系统识别代码坏味道？</td> <td>66条启发式规则（代码审查手册）</td> </tr> </tbody> </table> <hr> <h3 id="各章精读">各章精读</h3> <h4 id="第1章整洁代码为什么代价如此之高">第1章：整洁代码——为什么代价如此之高？</h4> <p><strong>核心论点</strong>：烂代码的代价不是线性的，而是指数级的。随着烂代码积累，生产力趋近于零，最终只有大规模重写一条路——而重写往往比继续维护更贵。</p>