当需求变更涉及多个文件时（例如统一替换弃用接口、批量添加错误处理、调整公共函数签名），逐一手动修改不仅效率低，还容易遗漏。CodeBuddy 支持在理解项目全局上下文的基础上，一次性规划并执行跨文件的代码变更。
典型使用场景
- 接口升级：后端 API 的入参或返回值结构发生变更，需要同步修改所有调用方及对应的类型定义文件。
- 重构公共逻辑：将散落在多个文件中的重复代码提取为公共函数，并替换原始实现。
- 统一规范落地：例如为所有异步函数补全 try-catch、统一日志打印格式，或批量替换旧版组件为新版本。
- 框架迁移：如从 Vue 2 Options API 批量改写为 Composition API 风格，或调整路由配置方式。
操作方式
- 绑定全局上下文
在侧边栏对话中，使用 @目录:src（或具体模块路径）将相关代码范围绑定到当前会话。此时 AI 已掌握目录下的文件列表与关键代码结构。
- 描述变更需求
用自然语言明确描述修改目标。例如："将 utils/request.ts 中的 getUserInfo 函数重命名为 fetchUserProfile，并同步修改 pages/home、pages/profile 及 components/header 下的所有调用处。" 描述越精确，生成的批量修改方案越准确。
- 审阅与执行
CodeBuddy 会生成变更计划，列出受影响的文件及每处具体改动。你可以逐文件审阅 diff，确认无误后选择"全部应用"或"部分采纳"。部分版本支持直接生成多文件的代码块，你只需点击对应文件的"插入"或"替换"按钮即可完成写入。
实用建议
- 先小范围验证：首次使用批量修改时，建议先对单个模块或少量文件试运行，确认 AI 理解符合预期后，再扩大范围到整个项目。
- 配合版本控制：执行批量修改前，确保当前工作区已提交或暂存（git stash / commit）。这样一旦某处改动有误，可通过
git checkout或git diff快速回滚比对。 - 警惕副作用：跨文件修改常涉及类型链、测试用例甚至配置文件。执行后务必运行一次编译（
npm run build或对应命令）和核心流程测试，确保没有破坏现有功能。 - 复杂变更分步执行：若改动涉及"改接口 → 改调用方 → 删旧文件"等多阶段，建议拆成多轮对话逐步推进，每步验证通过后再进行下一步，降低一次性回滚成本。