代码难以追踪时，用读者负担最小化原则重构层级与状态

在审查或塑造难以追踪的代码时，通过减少追踪层级和隐藏状态来降低读者的理解成本。

适用场景

解决思路

1. 追踪两个维度：从问题到答案之间有多少层间接引用（需追踪的层级），以及读者必须在脑中记住多少隐藏或可变上下文（需持有的状态）。
2. 认识到代码被阅读的次数远多于被编写，LOC、圈复杂度和“整洁架构”都只是代理指标，读者负担才是关键；两个维度相互独立，一个含 50 个全局变量的扁平文件可能与 6 层适配器栈一样难以推理，两者都要防范。
3. 折叠那些成本高于收益的层级：只有一个调用者的包装器、没有第二种实现的适配器、从未被需要的推测性间接层，统统内联。
4. 让相邻层改变抽象：如果某一层重复相同的方法和参数，它只增加读者负担而不带来压缩，应折叠这类直通层。
5. 要求接口压缩：一个宽泛却几乎不隐藏复杂度的接口，会迫使读者同时学习表面和实现，应优先选择能隐藏有意义决策的边界。
6. 缩小状态作用域：优先纯函数（返回而非修改），局部变量优于字段，字段优于模块状态，模块状态优于全局变量；用派生代替同步。
7. 在边界处命名不变量，而不是在每个消费者处重复，让读者只学一次。
8. 在添加一层或一份状态之前先问：它是否在别处至少等量地降低了读者负担？
9. 用测试验证：新读者能否在 30 秒内回答“X 从哪来？”和“什么能改变 X？”；如果不能，就削减层级或削减状态。