并发文件编辑（又名多文件编辑）

在单个操作中编辑多个文件，大大加快了重构和多文件更改的速度。

它的作用

并发文件编辑允许 Roo 在一个请求中修改你的工作区中的多个文件。你无需单独批准每次文件编辑，而是通过一个统一的批量批准界面一次性审查和批准所有更改。

为什么使用它

传统方法： 需要单独批准的顺序文件编辑

• 编辑文件 A → 批准
• 编辑文件 B → 批准
• 编辑文件 C → 批准

使用并发文件编辑： 所有更改一起呈现

• 审查跨文件 A、B 和 C 的所有提议更改
• 一次批准以应用所有更改

这减少了中断，并加快了复杂的任务，例如：

• 跨多个文件重构函数
• 更新整个代码库中的配置值
• 重命名组件及其引用
• 应用一致的格式或样式更改

如何启用

使用该功能

启用后，Roo 会在适当的时候自动使用并发编辑。你将看到一个“批量差异批准”界面，显示：

• 所有要修改的文件
• 每个文件的提议更改
• 批准所有更改或单独审查的选项

示例工作流程

1. 要求 Roo“将所有 API 端点更新为使用新的身份验证方法”。
2. Roo 分析你的代码库并识别所有受影响的文件。
3. 你收到一个单独的批量批准请求，显示以下文件的更改：

• src/api/users.js
• src/api/products.js
• src/api/orders.js
• src/middleware/auth.js

4. 在统一的差异视图中审查所有更改。
5. 批准以同时应用所有更改。

技术细节

此功能利用了 apply_diff 工具的实验性多文件功能。有关实现、XML 格式以及 MultiFileSearchReplaceDiffStrategy 如何工作的详细信息，请参阅 apply_diff 文档。

最佳实践

何时启用

• 使用功能强大的 AI 模型（Claude 3.5 Sonnet、GPT-4 等）。
• 能够轻松地一次性审查多项更改。

何时保持禁用

• 使用功能较弱的模型，这些模型可能难以处理复杂的多文件上下文。
• 更喜欢单独审查每次更改。

限制

• 实验性： 此功能仍在完善中，可能存在边缘情况。
• 依赖于模型： 配合功能更强大的 AI 模型效果最佳。
• 令牌使用： 由于上下文更大，初始请求可能会使用更多令牌。
• 复杂性： 非常大的批量操作可能更难审查。

故障排除

更改未批量处理

• 验证设置中是否已启用实验性标志。
• 检查你的模型是否支持多文件操作。
• 确保文件没有被 .rooignore 限制。

批准 UI 未出现

• 更新到最新版本的 Roo Code。
• 检查 VS Code 的输出面板是否存在错误。
• 尝试禁用然后重新启用该功能。

性能问题

• 对于非常大的批次，考虑将任务分解为更小的块。
• 如果 API 配额有限，请监控令牌使用情况。

另请参阅

• apply_diff 工具文档 - 详细技术信息
• 实验性功能 - 其他实验性功能
• .rooignore 配置 - 文件访问限制