principle-minimize-reader-load
这是一份面向代码评审与重构的维护性原则,核心是“最小化读者负担”。它主张可维护性的本质是读者理解代码所需付出的工作量,并用两条独立轴线衡量:追踪层数(问题与答案之间的间接层级)和需记忆状态(读者必须在脑中保持的隐藏或可变上下文)。LOC、圈复杂度、整洁架构等只是代理指标。该原则给出多项具体做法:内联只有一个调用方的包装器、没有第二实现的适配器及从未需要的推测性间接层;让相邻层改变抽象,折叠只是重复相同方法与参数的透传层;要求接口压缩,避免既暴露表面又暴露实现的宽接口;缩小状态作用域,优先纯函数、局部变量、字段、模块状态而非全局,用派生代替同步;在边界处命名不变量,使读者只需学习一次。新增层级或状态前应先问:它是否至少等量减少了别处的读者负担。检验标准是:新读者能否在30秒内回答“X从哪来”和“什么能改变X”。