principle-minimize-reader-load

尽量减轻读者负担

可维护性取决于读者理解代码所需付出的努力。关注两个维度：

1. 追踪层级。 从问题到答案之间有多少层间接关系。
2. 需要记住的状态。 读者必须在脑中保留多少隐藏或可变的上下文。

原因： 代码被阅读的次数远多于被编写的次数。代码行数、圈复杂度和“整洁架构”都只是替代指标。真正重要的是读者负担。这两个维度彼此独立。一个有 50 个全局变量的扁平文件，可能和一个包含 6 层适配器的调用栈一样难以推理。两者都要把控。这相当于面向人的 保护上下文窗口：读者的工作记忆同样有限。

实践方式：

• 合并没有实际价值的层级： 只有一个调用方的包装器、没有第二种实现的适配器，以及为一个从未到来的未来而引入的间接层。将它们内联。
• 缩小状态作用域： 优先使用纯函数（返回值优于修改状态）、局部变量优于字段、字段优于模块状态、模块状态优于全局变量。能推导就不要同步。
• 在边界处命名不变量， 而不是让每个使用方都重复说明，这样读者只需了解一次。
• 添加一层或一项状态之前，先问：它能否在其他地方至少同等程度地减轻读者负担？

检验标准： 新读者能否在 30 秒内回答“X 从哪里来？”和“什么会改变 X？”如果不能，就精简层级或状态。