用途:用于评审或塑造“难以追踪”的代码,判断可维护性高低。资料认为可维护性等于读者理解代码所需付出的工作量,应看两条相互独立的轴:追溯层数(问题与答案之间的间接层)与需记住的状态(读者脑中要保留的隐藏或可变上下文)。LOC、圈复杂度和“整洁架构”只是代理指标,真正重要的是读者负担。
主要能力与做法: 一是折叠“得不偿失”的层,例如只有一个调用者的包装、没有第二种实现的适配器、从未需要的投机式间接层,直接内联。 二是让相邻层改变抽象;若某层只是重复相同方法与方法参数,属于直通层,应予折叠。 三是要求接口压缩:宽接口若藏不住复杂度,读者既要学表面又要学实现;边界应隐藏有意义的决策。 四是缩小状态作用域:优先纯函数(返回而非修改),局部变量优于字段,字段优于模块状态,模块状态优于全局变量;用派生代替同步。 五是把不变量命名在边界处,而不是在每个消费方重复,使读者只需学一次。
使用方式:在新增一层或一份状态前自问——它能否在别处至少等量地降低读者负担?检验标准是:新读者能否在30秒内回答“X 从哪来”和“什么能改变 X”;若不能,就削减层数或削减状态。
适用场景与限制:适用于代码评审、重构决策与API/模块边界设计。资料未提供具体平台、命令、代码示例、收费方式或版本信息,暂未提供。