用途:该原则用于评审或调整难以追踪的代码,把可维护性定义为“读者理解代码所需付出的工作量”,而非行数、圈复杂度或“整洁架构”等代理指标。
主要能力:提出两个独立轴线。一是追踪层数,即问题与答案之间存在多少层间接;二是状态持有量,即读者必须在脑中记住多少隐藏或可变上下文。资料指出两轴相互独立:一个含50个全局变量的扁平文件,可能和6层适配器栈一样难以推理,因此两者都要防守。
使用方式:折叠不产生价值的层,例如只有一个调用方的包装、没有第二种实现的适配器、为从未到来的未来引入的间接,直接内联。缩小状态作用域,优先纯函数(返回而非修改)、局部变量而非字段、字段而非模块状态、模块状态而非全局;用推导替代同步。把不变式命名在边界处,而不是在每个使用方重复,让读者只学一次。在新增一层或一份状态前先问:它是否在别处至少等量地降低了读者负担。
适用场景:评审或重塑难以追踪的代码时使用。
限制与判断标准:资料未提供与具体语言、工具或框架绑定的安装命令和使用步骤。其检验标准是:新读者能否在30秒内回答“X从哪来”和“什么能改变X”;若不能,就削减层数或状态。