在实际项目中，批量改代码往往比写新代码更耗时。Cursor 提供了从半自动到全自动的几种路径，核心思路是先让 AI 理解意图，再决定是人工逐条确认还是交给 Agent 自动执行。
1. 小范围精准修改（2–5 个文件）
在侧边栏对话中，通过 @文件 逐个引用需要改动的文件，直接描述需求。例如："请把这 3 个文件里的 getUserData 函数都改为异步，并统一加上错误捕获"。AI 会分块给出每个文件的修改建议，你可以逐一点击 "Apply" 应用到对应位置。这种方式适合逻辑牵连不深的局部调整， retains 你对每一处改动的完全控制权。
2. 项目级自动批量修改（Agent 模式）
如果改动涉及十几个文件以上，或需要 AI 自己先找出哪里该改（比如迁移废弃 API、统一错误码格式），建议使用 3.5 节 介绍的 Agent 模式。操作步骤：
- 在侧边栏将对话模式切换为 Agent（通常显示为 "Normal" 的下拉选项）；
- 用自然语言下达任务，例如："把项目中所有使用旧版
axios拦截器的地方改成新的响应拦截格式，并同步更新类型定义"； - AI 会自动检索相关文件、生成修改、跨文件应用，并可能自动运行类型检查命令验证结果；
- 执行完成后，在源代码管理（Git）面板中审查所有 diff，确认无误后统一提交。
关键提示：Agent 自动执行前，确保工作区是干净的（已提交当前代码），这样一旦改崩了可以一键回退。
3. 规则化替换 + AI 兜底
对于纯命名变更、路径调整等规律性强的批量操作，先用编辑器原生的 全局搜索替换（Ctrl/Cmd + Shift + H） 处理 80% 的机械工作，再将拿不准的边界 case 丢给 AI 判断。不要事事都问 AI，否则既烧额度又慢。
4. 安全审查惯例
无论用哪种方式，批量修改后必须做三件事：
- 看一遍 Git 变更列表，确认没有误动无关文件；
- 对核心业务文件（如支付、权限、事务控制），关闭自动接受，改为逐块 Review；
- 运行一次项目自带的自动化测试或类型检查，AI 生成的代码语法常对，但逻辑可能漏掉边界条件。
效率口诀：
"简单替换用原生搜索，跨文件联动用 @ 引用，大规模重构用 Agent，改完必看 diff，测试通过再提交。"