Roo Code 上手指南装好 VS Code 的 AI 编码团队3 种任务一次讲清【免费下载链接】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 角色你只需要切换模式、说清楚要做什么。本文从安装讲到进阶配置覆盖 Roo Code 安装、使用模式、调试工作流和索引优化看完就能在你的项目里跑起来。它能替你干哪些活把 Roo Code 当成一个随叫随到的开发小队不同场景对应不同的分工写功能、改代码选中文本或描述需求它直接生成、修改、重构并执行终端命令验证。动手前先规划架构师模式先收集上下文、产出带步骤清单的实现方案你确认后它才切换到编码模式动手。看不懂旧代码问答模式只读不改适合解释函数、梳理模块关系、给出建议。排查线上/本地报错调试模式会先列出几种可能原因、加日志验证、再和你确认诊断后才修。复杂多步项目编排Orchestrator模式把大任务拆成子任务分派给合适的模式并行推进。团队沉淀经验用 JSON 定义专属模式提示词 工具权限共享给全组复用。这些角色的定义集中在 src/shared/modes.ts内置五个模式Architect、Code、Ask、Debug、Orchestrator。下面开始装。装好后侧边栏会出现 Roo Code 图标打开就是右边的聊天面板模式切换器就在顶部。3 分钟装好 Roo Code 并接上模型方式一市场安装推荐按CtrlShiftX打开扩展面板搜索 Roo Code点击安装。装完侧边栏图标就出现了。方式二从源码构建开发者想试特定版本或贡献代码时本地构建一个 VSIX 包git clone https://gitcode.com/GitHub_Trending/ro/Roo-Code cd Roo-Code pnpm install pnpm vsix code --install-extension bin/*.vsix安装脚本 scripts/install-vsix.js 会自动卸载旧版本也支持指定目标编辑器。首次运行接一个模型Roo Code 本身不带模型需要你提供一个 API Key。点面板里的设置选择提供商Anthropic、OpenRouter、OpenAI、Gemini 等均可填入 Key 并选一个默认模型发一句你好验证通过就算跑起来了。国内用户也可以走 OpenRouter 之类的聚合网关后面随时能在设置里换。装好并跑通之后第一件事是熟悉模式——这是 Roo Code 使用中最核心的概念。按任务切换工作模式别把 Roo Code 当成一个模型用而是当成一队模型用任务变了模式跟着换。要规划一个方案 → Architect架构师设计一个 RESTful API包含用户认证和数据校验它会先读代码、追问细节然后用 todo 列表把任务拆成可执行的步骤还会画 Mermaid 图辅助说明。你确认后它请求切到 Code 模式实施。模式切换入口见 apps/docs/docs/features/。要写码、修 bug、重构 → Code编码默认日常主力。选中文本右键交给 Roo或直接说把这个函数改成异步并加上错误处理。它可读文件、改文件、跑命令全程在 diff 视图里给你预览。只想问不想让文件被动 → Ask问答它只有读权限天然安全。比如解释git.ts里 getGitBranch 的实现逻辑适合接手陌生项目时快速建立理解。错误反复出现、抓不到根因 → Debug调试把报错贴给它或者让它自己跑测试。它的固定套路是列出 5~7 种可能原因 → 缩到 1~2 个最可疑的 → 加日志验证 → 让你确认诊断 → 才动手修。核心任务循环实现在 src/core/task/Task.ts。任务太大、跨多个领域 → Orchestrator编排它会用 new_task 工具把子任务委派给上面各模式跟踪每个子任务的完成情况最后汇总结果。多 agent 协作delegation的事件处理可以在 src/tests/delegation-events.spec.ts 的测试里看到完整行为约定。团队专属模式内置五款不够用在设置里新建自定义模式本质是一段 JSON{ name: 测试生成, roleDefinition: 为选中代码用 Jest 生成单元测试, groups: [read, edit] }能限制它能用的工具组比如只读、绑定固定模型也可以定义成项目级只在本仓库生效。更多字段说明见 packages/types/src/mode.ts。模式用熟了之后下一步是让它的回答更懂你的项目。让它更懂你的项目索引、忽略与检查点开代码库索引回答更贴切第一次问这个项目里 X 逻辑在哪这类问题时建议开启代码库索引Embedding Indexing。它会对项目文件做向量化检索Roo 找代码就不用满仓库 grep 了。用 .rooignore 排除无关文件让索引更快索引范围由 .rooignore 决定语法和 .gitignore 一样。大型仓库里把node_modules、dist、生成产物都写进去索引又小又快上下文也不会被垃圾文件污染。改崩了用检查点回滚Roo Code 每轮修改前会自动给工作区拍快照checkpoint面板上点检查点图标就能浏览历史、看 diff、一键恢复到任意一版。实现位于 src/core/checkpoints/。多人协作与远程控制通过 MCPModel Context Protocol一种让 AI 连接外部工具的开放协议服务器接入可以做到远程驱动任务、同步状态也可以接内部工具链。MCP 服务配置在 src/services/mcp/。项目变聪明之后剩下就是遇到问题时的自救手册。卡住了先看这里Q回答越来越慢、上下文总是爆先把 .rooignore 补全关掉或缩小索引范围再检查是否一次贴了太多文件——用 语法精确引用文件比让 AI 自己翻仓库省 token 得多。Q它做错了/行为怪怪的两条命令先试Roo: 显示输出日志看扩展内部日志确认无望后再Roo: 重置扩展状态清掉本地缓存配置。常见错误的处理逻辑在 src/utils/errors.ts。Q想换模型或调参数设置页里按模式单独设模型Sticky Model 机制会自动记住每种模式上次用的模型温度、上下文窗口等参数也都能按提供商调整。中文说明见 locales/zh-CN/README.md。问题解决了就是往下走的时候了。下一步去哪看官方文档apps/docs/docs/ 按入门 / 功能 / 进阶组织模式、MCP、浏览器操作都有专页。贡献代码仓库根目录的 AGENTS.md 是给 AI 和人类开发者都看的协作约定配合 package.json 里的 turbo 脚本跑 lint / test / build。版本动态CHANGELOG.md 记录每个版本的改动发布说明图在 releases/ 目录。报 bug / 提问按 apps/docs/docs/reporting-errors.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），仅供参考