CoFFee________的博客

重构通常始于发现代码中的问题迹象，即“代码异味”。这些异味是代码中可能存在更深层次设计问题的表面特征。学会识别这些异味是重构的第一步。

好的软件设计不是完全靠前期庞大的设计方案来完成的，而更多地是。

前面的章节主要聚焦在代码的局部，比如如何写好函数，如何设计好类。第十一章则把视野拉高，开始关注如何将这些干净的函数和类成一个。系统层面的整洁性在于，同时将系统层面的关注点（比如配置、启动、依赖管理）与核心业务逻辑分离开。

使用接口和抽象类来保护代码，使其不受实现细节变化的影响 ，更简单来说，不用直接调用实现类，而是调用接口，这样实现类任由你改，调用代码都不用改。单一权责是类的原则，类的名称应该描述其权责，命名正是可以帮助判断类的长度的第一个手段。系统应该由许多短小的类而不是少量巨大的类组成，每个小类封装一个权责，只有一个修改的原因，并与少数其他类一起协同达到期望的系统行为。它将“功能做什么”与“功能具体怎么实现”分离开来，让实现细节可以独立于使用它的代码而变化。内聚：如果一个类的变量被所有的函数使用，那么这就是最高的内聚。

测试驱动开发 (TDD) 是一种编写整洁代码的“规程”或“方法论”，而不仅仅是测试技术。JaCoCo 在运行测试后生成详细的覆盖率报告的工具， maven 引用。

这些外部代码是你的**“边界”直接且紧密地依赖**这些外部代码的具体类、方法、异常等细节，那么一旦外部代码发生变化，你的大量应用代码就可能需要修改，变得非常脆弱和难以维护。我们要将外来代码干净利落的整合进自己的项目中。

在某些系统中，查找某个 ID 的用户可能找不到，这是一个正常的操作结果（比如用户 ID 不存在），而不是一个程序错误。这个原则主要用在那些**“找不到”或者“为空”是一种常见且预期内的结果，而不是真正的错误或异常**的场景。它的唯一作用就是在不同的软件层次之间（比如从数据库层到服务层，或者从服务层到外部接口）传输数据。或抛出异常，返回一个实现了相同接口的“特殊情况对象”可能让代码更清晰。抛出异常时，不要只抛一个泛泛的异常类型 ， 应该提供清晰的、有。的错误消息，并且如果捕获了下层抛出的异常，应该将其。

对象应该隐藏它的内部数据，只暴露可以操作这些数据的“行为”（也就是方法/函数）。你创建一个“用户”对象，这个对象内部可能存着用户的姓名、年龄、地址等数据。但在好的面向对象设计里，你不应该让外部代码直接去随意修改这些数据（比如user.name = "新的名字";相反，你应该给“用户”对象提供一些方法，比如user.setName("新的名字");或。在这些方法里面，你可以控制数据的有效性（比如检查年龄不能是负数），或者做一些附带的操作（比如修改姓名时记录日志）。

你应该选择一套管理代码格式的简单规则。如果是团队，应该选择一套团队一致同意采用的简单格式规则。

注释的恰当用法是弥补代码表达意图时遭遇的失败，良好的代码，让读者看代码就能明白含义。代码在变动，在演化。注释并不总是随之变动。不准确的注释比没有注释要坏的多。注释算的上是一种没办法去除的恶。

怎样才能让函数表达其意图？该给函数赋予哪些属性，好让读者一看就明白函数是属于怎样的程序？如何让函数易于阅读和理解？核心目标： 写出的函数要像搭乐高积木一样，每个积木块（函数）功能明确，容易拿取，容易组装，容易看懂。

第一段代码变量毫无含义，4这个魔术数让人不知表达什么，int[] 可以用 Cell 类代替，改成第二段含义清晰，见名之意。