高枝个人博客 土木读研 · 计算机 × 土木的交叉笔记
返回列表

技术债不会消失,它只是换个人来还

「以后再重构」这句话的真实成本,往往由说的人不承担。接手祖传代码延毕半年后,我算了一笔账:技术债的利息结构,以及怎么把它变成导师能听懂的话。

研一刚进组,导师让我接手一个"祖传代码"——上一届师兄做的边坡参数反演脚本,跑了三年,零文档。

我打开第一个文件,看到第 47 行有个魔法数字 0.618,注释写着"师兄说这个有用"。

三个月后我延毕了半年。这篇算一笔账:代码里的"以后再说",最后是由谁来还的。

利息的三层结构

第一层:直接成本

重构本身要花的时间。这个最显眼,也最容易被接受。

第二层:机会成本

新任务来了,但你不敢动核心模块,因为不知道会踩到什么。

这个成本不体现在工时上,体现在课题进度上。我接手那个脚本后,前三个需求里有两个的排期被"风险评估"拖长了一周以上。

第三层:人员成本

这是最贵的。

代码复杂度超过某个阈值之后,下一个接手的人需要更长时间才能独立工作。我算了算:从上届师兄交付,到我第一次敢改核心逻辑,中间隔了差不多三个月。这三个月里,导师一直要配一个老员工兜底。

怎么算这笔账

我后来用了个很粗但好用的估算:

text
技术债年成本 ≈ 受影响模块数 × (新人上手月数 × 人力月成本) + 需求延期损失

举个具体的:师兄留了个 TODO"以后再优化性能",一句话的事。而我从能跑到敢改用了 2 个月。按月成本折算:

text
重构投入:  5 人日        ≈ 0.8 万
每年利息:  2 人月 × 3 万 ≈ 6 万
一年就回本

结论是:只要一个模块一年内有新人进入,就该考虑还债。

把它变成导师能听懂的话

技术债之所以容易被无限推迟,是因为它总在跟项目进度抢排期,而且说不出收益。

我的做法是把它翻译成项目语言:

技术表述 项目表述
这个模块耦合严重 新需求上线周期不可控
缺少测试覆盖 每次改动都有回归风险
依赖版本老旧 无法采用新工具链,开发效率受限
监控缺失 出问题无法定位,平均恢复时间长

一旦翻译过来,它就和"提升计算精度"放在同一个天平上了。

我现在给自己定的规则

  1. 同一个"以后再说"不能出现第三次。 第二次就必须进 backlog,并给个日期
  2. 重构单独排期,不塞在需求里——塞进去的都会被砍
  3. 重构前先补测试,没有测试的重构是换一种方式引入 bug
  4. 每次重构写一份记录,半年后你会感谢自己

第 4 条我坚持了两年,现在翻回去看,能清楚知道每个决定是在什么约束下做的。这对一个持续演进的项目来说,是很珍贵的上下文。

一点反思

写代码的时候,人容易把"代码整洁"当成职业素养;在项目位置上,人容易把"跑得起来"当成职业素养。

两个视角都片面。真实情况是:技术债的本质不是技术问题,是优先级问题。 它一直被推迟,不是因为大家不懂,而是因为总有一个更紧急的事情。

所以解法也不是"提高大家的技术审美",而是建立一个能让技术投入进入排期的机制。审美只能让该做的人更想做,机制才能让它真的被做。