AI Agent / 系统课时

先定位再修改

先定位再修改

“先定位再修改”要求在编辑前建立一条可验证的证据链:从用户可见现象找到入口,再沿调用链和数据流确认真正的责任位置,同时确定需要回归的测试范围。这样可以避免只修表面症状,或在错误层级增加补丁。

学习目标

  • 从错误现象或需求描述定位代码入口、关键调用方和数据写入点。
  • 用搜索结果区分“出现这个词的文件”和“真正承担行为的代码”。
  • 在修改前圈定最小改动面与测试范围,并用工作区状态确认没有提前编辑。

从现象建立定位假设

定位的第一步不是猜文件名,而是提取稳定线索。接口问题优先找路由、命令或事件名;业务行为问题找核心符号和状态字段;异常问题找错误文本、异常类型或日志关键字。一次只追一条主线,避免同时搜索十几个近义词导致上下文失焦。

例如,面对“取消订单后库存没有恢复”,可以先让 Claude Code 只做定位:

先不要修改文件。围绕“取消订单后库存未恢复”建立证据链:找出请求或事件入口,追踪到取消订单的核心函数,再找到库存数量被读取和写回的位置;列出直接调用方、关键数据对象和已有测试。每个结论都给出对应文件与符号,最后指出最小候选改动点。

用搜索结果验证调用链

仓库内搜索适合验证 Claude 的判断。下面的命令模板把 <SYMBOL> 替换为已经发现的函数、类或字段,把 <ROUTE_OR_EVENT> 替换为入口名称:

bash
git grep -n '<SYMBOL>' -- .
git grep -n '<ROUTE_OR_EVENT>' -- .
git status --short

预期输出

text
<PATH>/src/<FILE>:<LINE>:<MATCH>
<PATH>/tests/<TEST_FILE>:<LINE>:<MATCH>
<git status --short 无输出>

实际命中数量、路径和行号会因仓库而异。关键不是“搜到了字符串”,而是把定义、调用方、入口和测试串起来;如果同名符号很多,应继续按目录、类型或调用上下文缩小范围。

从现象到最小改动面的定位链

沿数据流确认责任位置

调用链说明“谁调用谁”,数据流回答“值在哪里变了”。继续定位时,要明确输入从哪里进入、经过哪些校验或转换、最终在哪一层产生持久化或外部副作用。一个常见误区是看到控制器里出现库存字段就直接修改控制器,而真正的一致性约束可能在服务层或事务边界内。

因此,每个候选修改点都应回答两个问题:它是否拥有这条业务规则,它的调用方是否都应该获得同样行为。若答案是否定的,就继续向上或向下追踪,不要用局部条件分支掩盖边界错误。

用测试范围反推改动范围

测试是定位结果的反向校验。若你认为问题在某个服务函数,应该能找到或新增针对该函数行为的直接测试;若函数被多个入口复用,还要检查这些调用方是否会因新行为受到影响。测试范围过大通常意味着责任边界还没找准,范围过小则容易漏掉回归。

当入口、调用链、数据变化、测试范围和最小候选改动点能互相印证时,再开始编辑。定位不是额外步骤,而是把一次代码修改从“可能碰对地方”变成“有证据地改在正确边界”。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

先定位再修改

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通