Roo Code 实战:5种AI模式让VS Code里的AI编码助手各就各位
【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code
Roo Code 是一款装进 VS Code 的 AI 编码助手:它能读你的项目、按你的自然语言指令改代码、跑命令、查资料,再通过模式(Mode,即预定义的角色与工具权限组合)区分写码、规划、问答、调试等不同工作方式。它适合想在编辑器里用 AI 完成日常编码,同时不希望交出代码控制权的人——所有改动都会先以 diff(差异对比)形式展示给你确认。装好后侧边栏会出现一只袋鼠图标,点进去就是你的工作台:
市场一键安装,配好模型跑通第一个任务
在 VS Code 里按 Ctrl+Shift+X 打开扩展面板,搜索 "Roo Code",确认作者是 RooVeterinaryInc 后点击安装。如果你用的是 VSCodium 这类无法访问 Marketplace 的编辑器,走 Open VSX 渠道安装。
装完它还不能干活,因为 AI 能力来自你自己提供的模型。打开 Roo Code 面板的设置,选择一个提供商(OpenAI、Anthropic、OpenRouter 等都支持,完整清单在 providers 文档),填入 API Key 并指定模型。
然后在聊天框输入一句自然语言,比如"创建一个文件 hello.txt,内容为 Hello, world",回车发送。它会列出打算执行的动作——读什么文件、写什么内容、跑什么命令——逐项等你批准。这是它的工作方式:每一步都经你点头。本地构建也可以一条命令完成:
git clone https://gitcode.com/GitHub_Trending/ro/Roo-Code cd Roo-Code && pnpm install:vsix它会自动装依赖、打包 VSIX 并安装到编辑器,具体逻辑见 scripts/install-vsix.js。
三个高频场景:写、问、查
改代码(Code 模式)。你要做什么:让 AI 动手改文件。怎么做:在 Code 模式下直接描述任务,或选中代码后通过编辑器右键交给它。会得到什么:带绿色/红色标记的 diff 预览,你批准后才真正落盘;文件读写、命令执行等工具的实现集中在 src/core/tools/。
问代码(Ask 模式)。你要做什么:理解一段陌生的实现,比如某个工具函数的行为。怎么做:切到 Ask 模式提问,可引用具体文件作为上下文。会得到什么:解释与文档。注意该模式只读,不会改你的代码——这正好防止它"顺手"多改几处。
查问题(Debug 模式)。你要做什么:定位一个偶发错误。怎么做:切到 Debug 模式描述症状,它会按"加日志、隔离范围、确认根因"的思路推进。会得到什么:带排查步骤的诊断过程和修改建议,每一步同样走审批。
卡住了?先对照这4条
- 发送任务后报错或卡住:多半是没配 API 提供商,回到设置完成提供商配置。
- 想让 AI 读日志、跑测试,它却不动手:当前模式没有对应工具权限,切回 Code 模式或新建自定义模式。
- AI 改了不该改的文件:给模式加文件限制,或改用 Ask 这类只读模式约束它。
- 行为怪但说不清原因:按 Ctrl+Shift+U 打开输出面板,选 Roo Code 日志看每一步调用记录。
进阶:检查点回滚、rooignore 与自定义模式
改坏了怎么办?Roo Code 支持检查点(Checkpoint):每次任务前自动给仓库拍快照,出问题的改动可以回滚到任意快照,实现见 src/core/checkpoints/。
另外值得花十分钟调两处配置:
.rooignore:写在项目根目录,语法类似.gitignore,用来把node_modules、构建产物等排除在代码索引外,减少噪音(控制器在 src/core/ignore/)。- 自定义模式:把团队的工作习惯(角色设定、允许的工具、文件限制)固化成一个模式,多人共用同一套约束。
Roo Code 的设计取向很清晰:能力给足,控制权留在你手里——模式管权限,diff 管确认,检查点管后悔。把它当默认工作流用一两周,你会很快形成自己的模式组合。
延伸阅读(仓库内):
- 安装指南:apps/docs/docs/getting-started/installing.mdx
- 第一个任务教程:apps/docs/docs/getting-started/your-first-task.md
- 模式与工具定义:src/shared/modes.ts、src/shared/tools.ts
- 任务执行核心:src/core/task/
- 工具实现目录:src/core/tools/
【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考