跳到主要内容

22 个文件被涂抹——调用点归因如何险些把假精度当成真发布

· 阅读需 4 分钟
Nudo Contributors
Nudo maintainers

发布系列(5/5)—— 2026-09-21 同日成套发布。建议按序阅读: Day 0 —— 不改写就观察 JavaScript · 契约就是 JS —— Day 1 与侧车 *.nudo.js · Nudo vs TypeScript —— 何时该选 JS-first 门禁 · 面向 coding agent 的 Nudo —— agents.md、agent 集成与稳定诊断码 · 22 个文件被涂抹——调用点归因如何险些把假精度当成真发布

调用点发现(nudo test lib/ --from test/)从使用处采集真实实参形态并合成 call@L… case。承诺是零成本精度:不要指令、不要标注,只要你的代码实际被调用时的实参。

零成本精度有黑暗面:归因到错误函数的精度看起来和成功一模一样。这是归因门的故事——一个 bug 让一个测试 helper 在 22 个文件里制造出 51 条假的「精确」结果,以及关住它的三条不变量。

症状​

第一次对真实包的试验里,覆盖率数字跳涨——@hapi/hoek 从 54.8% 到 98.6% 的函数有了精确 case。好得可疑。翻看合成 case 找到了原因:一个定义在测试文件里的 helper 恰好与 22 个库文件里的函数同名。它的一条调用记录被匹配到了每一个声明了同名函数的文件。22 个文件、51 条记录,全是假的:每一条「精确」结果都是 helper 的记录穿着别的函数的名字。

试验数字是一次对谎言的忠实测量。

不变量:归因,而不是名字匹配​

修复是归因门:只有当记录被解析出的模块实际指向该文件时——经调用的函数模块,或所绑定导出的目标模块——这条调用记录才参与该文件的匹配。只靠名字匹配,早晚会撞上同名 helper;门让模块身份成为真相源。

另外两条不变量补上剩余缺口:

  • 使用处泄漏标记。 在执行使用处代码期间捕获的记录会被标记。它们作为实参证据被信任——调用方传入的形态是真实的——但求值器绝不把测试本地的求值环境当成库自身的环境。
  • never / never 过滤。 结果类型为 never 且抛出类型为 never 的记录并没有真正返回——求值在调用中途被打断(如 new Promise(async ...) 执行器里的 await)。这些记录在注入前被过滤,而不是当作「返回 never」。

有意义的数字​

加上门之后,诚实的试验数字是 @hapi/hoek 98.6% 覆盖率、0 条错误归因(从 291 条假记录降下来);@discoveryjs/json-ext 91.8%、0 条假记录。头条数字几乎没变——但只有零这一列让它有意义。

没有归因故事的精度声明都是营销。Nudo 发布的每个关于调用点发现的数字都被这三条不变量门禁;完整设计(安全边界、合并策略、--from 天花板)在 调用点发现指南,诚实边界在 Limits。

为什么这对产品重要​

Nudo 的契约是「忠实观察」。假的精确结果比 unknown 更糟:unknown 告诉你引擎没有信息;假精度则自信地告诉你错误的信息。归因门不是性能优化——它是推断与编造之间的分界线。

运行 nudo test --from 就继承了这套安全设计。守护你 CI 诚实的合并策略与 --from 边界都写在指南里;未覆盖函数的 entry@ 回退就是诚实的下限。