SuperAPI AI 工具集

principle-minimize-reader-load

通用与其它

查看项目

更新于 10-16 07:20

技能介绍

用途:在评审或调整难以追踪的代码时使用。它把可维护性定义为“读者理解代码所需做的工作”,而非 LOC、圈复杂度或“整洁架构”等代理指标。

两个独立维度:需要追踪的层级(问题与答案之间的间接层数)与需要记住的状态(读者脑中要保留的隐藏或可变上下文)。二者互不替代:一个含 50 个全局变量的平铺文件,可能和六层适配器栈一样难推理。

主要做法:

  • 内联成本高于收益的层级,例如只有一个调用者的包装、没有第二种实现的适配器、从未用到的推测性间接。
  • 让相邻层级改变抽象;若某层重复相同方法与参数,只是纯转发,就合并。
  • 要求接口压缩:只掩盖很少复杂度的宽接口,会让读者同时学习表层与实现;优先选择能隐藏有意义决策的边界。
  • 缩小状态作用域:优先纯函数(返回而非修改),局部变量优于字段,字段优于模块状态,模块状态优于全局;用派生代替同步。
  • 在边界处命名不变量,而不是在每个使用方重复,让读者只学一次。

判断标准:新增一层或一份状态前,先问它是否在别处至少等量地降低了读者负担。测试方法是:新读者能否在 30 秒内回答“X 从哪来”和“什么会改变 X”;若不能,就削减层级或削减状态。

限制:资料未提供安装方式、命令、平台支持、收费与具体工具集成信息,暂未提供。