Roo Code 上手指南：VS Code 里装一支 AI 编码团队，改代码、查错、问架构全搞定

Roo Code 上手指南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-CodeRoo Code 是一款装在 VS Code 里的 AI 辅助编码插件官方定位很直白给你的编辑器配一整支 AI 开发团队。它解决的不是AI 陪聊代码的问题而是让 AI 真正在你打开的项目里干活的问题——读文件、改文件、跑命令、查报错全程在你眼皮底下执行。这篇文章不讲功能清单直接从一个真实小任务开始让你先看到它怎么工作再一层层展开模式、上下文、检查点这些进阶能力。装好它跑通第一个任务最省事的装法是打开扩展面板CtrlShiftX搜索 Roo Code点安装。装完侧边活动栏会多一个袋鼠图标点它就打开了主面板。想装特定版本或者想从源码构建也可以手动来# 克隆仓库 git clone https://gitcode.com/GitHub_Trending/ro/Roo-Code # 安装依赖 cd Roo-Code pnpm install # 构建 VSIX 扩展包 pnpm vsix构建脚本和安装辅助逻辑分别在 src/esbuild.mjs 和 scripts/install-vsix.js。装好、接上你自己的 API KeyAnthropic、OpenAI、Gemini 等主流供应商都行面板就可用了。别急着研究设置先扔一个最小任务给它试试手感创建一个文件 hello.txt内容写 Hello, Roo!回车发送后重点来了Roo 不会直接动手而是先给你看它打算做什么——要读哪个文件、要写入什么内容diff 形式绿色新增、红色删除、要执行哪条命令——每一步都等你的 Approve 或 Reject。你批准一步它才走一步走完一轮再来汇报下一步。这个提案→审批→执行的循环是它整个交互的底座也是新手最该先建立的心理预期它是个勤快但守规矩的实习生不是黑盒。同一只袋鼠五种岗位模式怎么用Roo 的多模式不是皮肤切换而是给 AI 换了角色设定和工具权限。日常你其实就是在四个岗位间来回切改代码Code默认全权限工程师读写文件、执行命令都可以。选中一段函数说改成异步并加错误处理它会给出 diff 等你批准。做设计Architect只读文件加只写 Markdown逼它先出方案再动手适合设计一个带认证和数据校验的 RESTful API这类规划题。问代码Ask纯只读不碰文件不跑命令专门用来解释实现比如讲一下 src/utils/git.ts 里取分支名的逻辑还能画图辅助说明。查错误Debug全权限但提示词被调教成系统化排错先分析、再缩小范围、加日志、确认根因后才动刀。切换有三种方式都很快点聊天输入框左侧的下拉菜单在消息开头打斜杠命令/code、/architect、/ask、/debug快捷键 Ctrl .macOS 是 ⌘ .每按一次循环切到下一个模式。一个贴心细节每个模式会记住你上次为它选的模型。你可以给 Code 模式配便宜快模型给 Architect 模式配最强模型切模式时自动跟着换不用每次手动选。模式的定义与合并逻辑在 src/shared/modes.ts。让它先读懂你的项目再谈效率新会话里 Roo 会自动附带工作区的文件树概览即环境详情但大项目靠这个还不够三个工具帮你把上下文管好代码库索引。设置里开启 Codebase Indexing 后Roo 会对项目文件做向量化索引之后你问哪里处理了登录过期它可以用语义检索精准定位而不是靠文件树瞎猜。适合中大型仓库。 提及。提问时直接 文件、目录、file:文件名 显式塞上下文比如src/core/task/ 这段任务恢复逻辑有没有并发问题。这是新手最容易忽略、但性价比最高的用法。.rooignore。项目根目录放一个.rooignore语法和.gitignore完全一致node_modules/ *.log config/secrets.json它的作用是让 Roo 既不读也不改这些文件等于给 AI 划了禁区——密钥、构建产物、生成代码都能挡在外面。文件改动会自动热加载不用重启。相关实现分散在 src/core/ 下的 context-tracking、ignore 等模块。改坏能回滚、规则能固化检查点与自定义模式检查点Checkpoints默认开启。Roo 在你每次任务开始、每次写文件之前用一个影子 Git 仓库给工作区拍快照注意它本地装 Git 即可不需要任何 GitHub 账号也和你的主仓库配置互相独立。快照会出现在聊天历史里点一下就能回退到那个状态、或对比差异。大项目首次初始化慢的话可以在设置里把Checkpoint initialization timeout从默认 30 秒调到最长 60 秒。自定义模式。把团队规范固化成岗位设置里可以新建模式定义角色描述roleDefinition、适用场景whenToUse、专属指令customInstructions还要勾选它允许使用的工具组read/edit/command/mcp。比如建一个测试工程师模式只给 read 权限指令里写死用 Jest必须覆盖边界情况以后切过去就是合规的测试生成器。配置结构定义在 packages/types/src/mode.ts官方有详细文档 apps/docs/docs/features/custom-modes.mdx。MCP 服务器。想让这支团队接入外部系统数据库、浏览器、内部工具走 Model Context Protocol 即可设置里配置 MCP 服务Roo 就能把外部工具当自己的能力用。避坑清单问题 → 怎么办你会遇到的情况处理办法大项目里它反应慢、上下文乱用.rooignore排除node_modules/、build/、日志目录开启代码库索引检查点初始化时出现超时警告设置 → Checkpoints把初始化超时调大到 60 秒它把代码改得不对想回退在聊天历史里找检查点一键恢复到那个状态担心它读密钥文件.rooignore加一行config/secrets.json越界访问会被直接拦截它开始乱跑命令切到 Ask/Architect 模式没有 edit/command 权限或用自动审批设置把执行类操作设成必须手动批准想确认它到底能干什么打开 官方文档或看核心实现 src/core/、API 接入层 src/api/下一步看哪里装完、跑通第一个任务、切过两个模式Roo Code 就已经是能用的状态了。想深入按这个顺序看仓库里的文档最高效模式详解 → 代码库索引 → 检查点 → .rooignore → 自定义模式。更新历史在 CHANGELOG.md。把你的真实项目丢进去让这支袋鼠团队先从写测试、补文档这种不伤筋动骨的活干起信任建立之后再放开手让它改核心代码。【免费下载链接】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），仅供参考