企业官网建设流程全解析

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-Code

Roo Code 是一款装在 VS Code 里的 AI 辅助编码插件，官方定位很直白：给你的编辑器配一整支 AI 开发团队。它解决的不是"AI 陪聊代码"的问题，而是"让 AI 真正在你打开的项目里干活"的问题——读文件、改文件、跑命令、查报错，全程在你眼皮底下执行。这篇文章不讲功能清单，直接从一个真实小任务开始，让你先看到它怎么工作，再一层层展开模式、上下文、检查点这些进阶能力。

装好它，跑通第一个任务

最省事的装法是打开扩展面板（Ctrl+Shift+X），搜索 "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 Key（Anthropic、OpenAI、Gemini 等主流供应商都行），面板就可用了。别急着研究设置，先扔一个最小任务给它试试手感：

创建一个文件 hello.txt，内容写 "Hello, Roo!"

回车发送后，重点来了：Roo 不会直接动手，而是先给你看它打算做什么——要读哪个文件、要写入什么内容（diff 形式，绿色新增、红色删除）、要执行哪条命令——每一步都等你的 Approve 或 Reject。你批准一步，它才走一步，走完一轮再来汇报下一步。这个"提案→审批→执行"的循环是它整个交互的底座，也是新手最该先建立的心理预期：它是个勤快但守规矩的实习生，不是黑盒。

同一只袋鼠，五种岗位：模式怎么用

Roo 的"多模式"不是皮肤切换，而是给 AI 换了角色设定和工具权限。日常你其实就是在四个岗位间来回切：

• 改代码（Code，默认）：全权限工程师，读写文件、执行命令都可以。选中一段函数说"改成异步并加错误处理"，它会给出 diff 等你批准。
• 做设计（Architect）：只读文件加只写 Markdown，逼它先出方案再动手，适合"设计一个带认证和数据校验的 RESTful API"这类规划题。
• 问代码（Ask）：纯只读，不碰文件不跑命令，专门用来解释实现，比如"讲一下 src/utils/git.ts 里取分支名的逻辑"，还能画图辅助说明。
• 查错误（Debug）：全权限，但提示词被调教成系统化排错：先分析、再缩小范围、加日志、确认根因后才动刀。

切换有三种方式，都很快：

1. 点聊天输入框左侧的下拉菜单；
2. 在消息开头打斜杠命令：/code、/architect、/ask、/debug；
3. 快捷键 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 就能把外部工具当自己的能力用。

避坑清单：问题 → 怎么办

下一步看哪里

装完、跑通第一个任务、切过两个模式，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