技术债务常被当成团队能力问题,实际上它首先是决策的结果:为了赶窗口期、抢收益,主动选择先上线、后补齐。债务本身是中性的,真正决定后果的是利息高低和偿还能力。本文基于一次历史项目治理的实践整理,讨论如何让债务可见、可量化、可排期。
债务从哪里来
历史项目出现债务,通常不是因为某一次错误,而是长期缺少清理机制:
- 代码在不同项目之间复制迁移,重复部分随时间增加;
- 功能仍在运行,但回归测试成本持续上升;
- 新需求需要先理解旧逻辑,迭代维护越来越困难;
- 新功能开发周期变长,投入产出比下降;
- 长期处理债务会消耗开发人员的心态与耐心。
这些现象背后是五类债务:
| 类型 | 典型表现 |
|---|---|
| 代码债务 | 重复代码、坏味道、风格混乱、魔法值、条件分支过多、异常处理缺失、安全风险、严重耦合 |
| 设计债务 | 缺少设计、对非功能性需求认识不足、系统性风险 |
| 测试债务 | 缺少测试、覆盖率不足、有测试但长期不运行 |
| 质量债务 | 缺少稳定性与健壮性验证、版本控制模糊、环境参数混乱 |
| 文档债务 | 没有技术文档或设计文档、文档过期 |
五个可观测信号
把债务当成贷款,判断是否该“还”的核心是利息。以下信号可以用来度量利息是否正在上升:
- 交付速度下降。 正常迭代下,单位时间完成的任务量应保持接近;如果明显下滑,通常不是人员突然变慢,而是理解、修改和验证的成本变高。
- 测试覆盖率下降。 覆盖率工具给出的数字不必追求满分,但持续下降意味着改动缺少安全网。
- 静态检查告警增加。 历史代码中的规则告警长期不处理,会掩盖新引入的问题。
- 线上缺陷不降反升。 没有大版本开发时,缺陷数量本应缓慢下降;若维持高位甚至增加,说明稳定性在恶化。
- 理解成本高于实现成本。 新增功能可能只需要 100 行代码,但搞清楚它应该放在哪个模块、会影响哪些系统,往往要花数倍时间。
这五个信号不需要同时出现。出现任意两个并持续一个迭代周期,就值得进入治理排期。
四种偿还策略
策略没有绝对好坏,选择标准是投入产出比:
| 策略 | 做法 | 适用条件 | 主要风险 |
|---|---|---|---|
| 重写 | 推翻重来,一次还清 | 边界清晰、行为有测试或可对照、业务窗口允许 | 周期长,容易在重写期间丢失隐性规则 |
| 维持 | 修修补补,只还利息 | 模块即将下线,或改动频率极低 | 利息持续累积,最终无法维持 |
| 重构 | 新旧交替,分期偿还 | 大部分场景,可按模块小步替换 | 缺少测试时容易改出回归 |
| 投资 | 在新建模块中采用更好的设计与规范 | 新项目、新服务 | 只对新代码生效,旧债仍在 |
此外还有两种日常动作:
- 测试与评审:代码审查、单元测试、设计评审属于预防性投入,成本低于事后治理。
- 记账:因进度压力走了捷径,就把债务记录到任务系统,明确后续偿还批次,而不是依赖记忆。
落地路径
治理顺序可以概括为四步:达成共识 → 债务可见 → 及时止损 → 持续改善。
- 建立共识。 让团队理解债务会直接影响业务交付,而不只是代码美观问题。共识不靠一次宣讲,靠把债务与具体业务指标关联起来。
- 识别并标记。 从服务依赖、文件职责、函数复杂度、重复代码、魔法值、接口参数等维度盘点,汇总到统一的问题池,并关联业务线。
- 排期与止损。 优先处理影响服务稳定性和线上故障的问题,再按与业务的相关程度分级。新增代码执行更严格的规范,避免边还边欠。
- 循环复盘。 用 PDCA 推进:规划、执行、检查、调整;用 WBS 拆解任务、识别依赖和关键路径;用 MVP 控制单批范围,先交付可用结果,再迭代完善。
几个工具在其中的作用:
- PDCA:把治理变成持续循环,而不是一次性运动;
- WBS:把“治理技术债务”拆成可分配、可验收的任务;
- MVP:先解决最痛的一段,用结果争取后续资源;
- ROI:用投入产出比决定先还哪一笔,而不是按技术洁癖排序。
边界与误区
- 债务不等于坏代码。 有明确偿还计划的捷径是融资;没有计划的捷径才是负债。
- 重写不是默认答案。 缺少测试和领域知识时,重写的失败率高于渐进重构。
- 治理不等于停机整理。 可持续的做法是把清理嵌入日常迭代,每批次消化一部分。
- 指标不能代替判断。 覆盖率、告警数、缺陷数都是信号,不是目标本身;为了指标而写测试,会制造新的债务。
小结
- 技术债务是主动或被动决策的结果,关键指标是利息与偿还能力。
- 债务分为代码、设计、测试、质量、文档五类,表现不同,治理手段也不同。
- 交付变慢、覆盖率下降、告警增加、缺陷上升、理解成本变高,是可观测的五个信号。
- 重写、维持、重构、投资各有适用边界,选择依据是投入产出比。
- 落地靠共识、可见、止损、复盘四步循环,而不是一次性的清理行动。