让 AI 在改代码前梳理回归范围
先指定要修改的函数、字段或页面,让 AI 逐层追踪调用关系,列出受影响的界面、API 和测试,并标注文件与行号。改完后按清单跑测试、手动检查用户可见流程,影响面过大时就拆分变更。
AI 深度解读
改一个共享函数,最容易漏掉的是隔了几层调用的页面。作者建议把影响分析放在 AI 写代码之前:先让它沿调用关系找到受影响的文件、页面、API 和测试,逐项给出文件与行号。改完后跑测试,再打开清单上的页面,走一遍用户会走的流程。
这套方法最实用的地方,是把「这次改动可能影响哪里」变成一份能逐项验证的清单。即使最后由你自己改代码,提前查到的调用关系也能帮你决定这次该改多大。
为什么要先把要改的东西说具体?
先点明你要动的是哪个函数、哪个数据字段、哪个页面,还是哪项配置。让 AI 查「这次调整结算会影响哪里」,它很难判断该从哪个入口找。指定一个函数或字段,它才有明确的起点。
以函数为例,先找直接调用它的位置,再找谁调用了这些调用方,一层层追到页面、API 和测试。比如一个金额格式化函数可能只在某个工具文件里被直接调用,但工具文件的结果又被订单列表和详情页使用。只搜函数名,第一层就找完了,两个页面却还没进清单。让 AI 为每项给出文件和行号,你就能回到代码里确认这条依赖是怎么连起来的。
改完以后,按什么顺序验?
写代码之前,先从清单里挑出用户能察觉的变化。文件和行号方便查代码,页面和流程才是手动验证的入口。比如改的是金额展示,就要知道该打开哪些页面,以及要走到哪一步才会看到金额。
改完先跑测试,再打开清单上的每个页面,走完标出的流程,逐项确认。如果写代码前就发现清单很长,作者建议拆成几次小改动,每次改完先检查,再继续下一步。这样一旦某个页面出问题,排查可以先从刚完成的那一步开始。
我的判断
我赞成把影响清单放在改动前。改完再看 diff 可以复核实现,但第一次发现共享逻辑牵涉多个入口时,代码可能已经写了一大半。提前知道这些入口,才来得及调整改动范围,也能在测试之前想清楚要手动看哪些页面。
文章主要是经验之谈。作者提到团队用一套免费的 AI starter kit 做影响分析,但没给出具体改动案例、漏检率或对照数据,也没交代工具如何处理动态引用。对于 TypeScript 里能静态解析的符号,IDE 的「查找所有引用」就能核对直接调用。AI 可以帮忙把多层调用串起来,但遇到配置驱动的入口或运行时拼接的字段名,清单有没有漏项,还得结合项目的实际接线方式核对。
能拿来做什么
- 改共享函数前,把文件路径、函数名和计划改变的行为一起交给 AI,让它先查到页面、API 和测试,并为每项附上文件与行号。
- 改接口返回字段前,让 AI 从字段定义追到前端读取它的位置,再把对应页面和操作步骤记进清单。改完跑测试,并手动走一遍这些步骤。
- 如果一个改动牵出多个用户流程,先看能否按可独立验证的行为拆开。每完成一小步,就核对对应的测试和页面,再动下一步。