术语

理解债

理解债(comprehension debt)是一个组织正在运行的软件与它内部还有人能解释的软件之间不断扩大的落差——只要能跑的代码产出得比对它的理解更快,这笔债就在累积,并在第一次没人敢动的改动上结账。

又称 comprehension debtAI 技术债没人读过的代码欠下的债

在实践中

普通的技术债欠在代码质量上:代码乱、走过的捷径心里有数,而且关键在于——作者通常还找得到。代码再差,背后总有一个能回答「这里当初为什么这么处理」的人脑。AI 生成的代码把这个最后的兜底也抽走了:它的「作者」是一个无状态的模型会话,生成完那一刻就不存在了,当时的判断、权衡、取舍一点没留下可追溯的记录。于是团队手上是一坨能跑、但谁都无法解释、也无人可问的实现。本站从 2026 年起用「理解债」来点名这个特定的差别——欠的不是代码质量,欠的是「再也没人能为它负责地解释」。

这笔债带利息,所以团队通常在第七个月而不是第一个月遇到它。第一次改动,是一个并没有读懂旧代码的 AI「在旁边加一块」;第二次改动,它面对的是旧代码加上上次那块没人理解的新代码,于是再加一块。每一层都叠在一层没被理解的东西上,理解成本上升得比团队的直觉快——曲线前期平缓、令人安心,然后在某个再普通不过的需求上陡然变陡。一份已发表的记述里,一个用两天搭起报销系统的零售财务团队,在第七个月为一次税率调整排了三周;而 AI 顺手改动的一处与抵扣无关的对账逻辑,是在上线前评审时才被拦下的。

这种状态不需要什么特别的工具就能测量,因为它的症状是行为层面的。下面五条中占了三条,团队就已经在积累它了:系统里有一块代码,队里没人解释得清它为什么这么写;要改一处,第一反应是「这会不会弄坏别的地方」,而不是直接改;每次要改,都得先把整块代码重新喂给 AI 让它「再读一遍」;PR 大到没人能逐行评审,于是唯一还能查的只剩「测试过了没」;而「改」的诚实工期估算,已经悄悄超过了「重写」。

这套机制跟具体哪家厂商的工具无关——它只源于「实现产出的速度超过了组织吸收它的速度」,任何团队用任何代码生成工具都会遇到。所以只有两个把手:把生成放慢,或者把产物变小。ObjectStack 选第二个:让 AI 生成带类型的应用元数据而不是实现,于是留存下来的是一份第七个月还读得懂的定义,而所有人依赖的那部分实现是一个被反复审计的运行时,不是每个应用一坨没人读过的新代码。

这个术语用在哪里

真正用到这个术语的页面与文章。