roo-code-deepseek-blog

Tiam-2016

240人浏览 · 2026-11-03 09:44:26

Tiam-2016 · 2026-11-03 09:44:26 发布

Roo Code + DeepSeek 实战：在 VS Code 里搭一套全中文的 AI 编程助手

不用汉化补丁，不用梯子，不用订阅 Copilot。一个开源插件 + 一个 API Key，十分钟搞定。

一、先说结论

如果你和我一样，想要的是「中文界面 + 能自己填 API Key + 真能改代码」的 AI 编程助手，那基本只有一条路走得通：

Roo Code（VS Code 插件）+ DeepSeek API。

我前后试过 Cline、通义灵码、CodeBuddy，最后落到这套组合上，原因很实在：

方案	中文界面	能否接 DeepSeek	说明
Roo Code	✅ 官方内置简体中文	✅ 原生 Provider	开源，功能最全，本文主角
Cline	❌ 官方无中文	✅	生态最大，但界面全英文，汉化版跟不上版本
CodeBuddy	✅ 原生中文	✅ 需 `models.json` 手配	中文体验最好，但整体绑定腾讯生态
Cursor	❌	⚠️ 仅自家模型	不是插件，且按订阅收费

Roo Code 是 Cline 的分支，但补上了 Cline 一直没做的两件事：多语言 和 更细的模式划分。而 DeepSeek 在这套组合里是性价比最高的模型——Roo Code 甚至为它单独写了 provider，不是拿 OpenAI 兼容模式硬凑。

二、准备工作

只准备两样东西：

VS Code（1.8x 以上版本都可以）
DeepSeek API Key

Key 的获取路径：打开 platform.deepseek.com → 左侧「API keys」→ 新建 → 复制那串 sk-xxxxxxxx。

⚠️ 注意：新账号的赠送额度早就取消了，Key 建好之后要单独去「充值」页面充钱，否则调用会直接报鉴权失败（而不是提示余额不足，这点很坑，后面踩坑章节细说）。

三、安装插件

在扩展面板搜索 Roo Code，认准发布者 Roo Veterinary，点安装。

习惯命令行的可以直接敲：

code --install-extension RooVeterinaryInc.roo-cline

装完之后左侧活动栏会多出一个袋鼠图标。

首次点击会弹出「是否信任此工作区」的提示——必须点信任。这不是可有可无的授权，Roo Code 的所有能力（读写文件、执行命令、跑 git）都建立在工作区信任之上，拒绝之后它就是个只能聊天的复读机。

四、接入 DeepSeek（核心步骤）

点面板右上角的齿轮图标进入设置，左侧选 Providers。

API Provider 下拉框里直接就有 DeepSeek 这一项，不用选 OpenAI Compatible。选中后按下面填：

配置项	填写内容
DeepSeek API Key	`sk-` 开头的那串
Base URL	留空，默认就是 `https://api.deepseek.com`
Model	`deepseek-chat`（推荐先从这个开始）

📷 图 2：Providers 页面填写 API Key 与模型

内置的模型预设只有两个，对应 DeepSeek V3.2 的两个模式：

deepseek-chat：非思考模式，响应快，适合日常写代码
deepseek-reasoner：思考模式，带思维链，适合算法、复杂重构

两个都是 128K 上下文 / 8K 最大输出。价格方面，V3.2 是 输入 $0.28/百万 token、输出 $0.42/百万 token，而命中缓存的输入只要 $0.028/百万——便宜十倍。这个缓存机制后面会重点讲，是压成本的关键。

📷 图 3：模型下拉列表

填完点右上角 Done 保存。API Key 会存进 VS Code 的 SecretStorage，不会写进任何配置文件，不用担心误传到 Git。

如果 DeepSeek 出了新模型怎么办

Roo Code 的预设列表是写死在代码里的，平台上线新模型（比如 V4 系列）后，预设里往往还没有。这时候别死等更新，直接用 OpenAI Compatible 提供商：

Base URL：https://api.deepseek.com/v1
Model：手填平台文档里的模型名（如 deepseek-chat、deepseek-reasoner 或新的型号）
Context Window：128000
Max Output：8192

五、切成中文界面

Roo Code 的中文是官方内置的，靠 i18n 实现，不是民间汉化。

设置页 → 左侧 General（通用） → Language → 下拉选「简体中文」→ 点 Save。

📷 图 4：Language 下拉选择简体中文

保存后界面立即刷新为中文，不需要重启 VS Code。

六、跑通第一个任务

在底部输入框敲一句真实需求，比如：

读一下 src/utils/date.ts，把 moment 替换成 date-fns，保持现有函数签名不变

然后按回车，你会看到它开始：

列目录 / 搜文件 —— 找到目标文件
读文件 —— 把内容拉进上下文
写 diff —— 每个被改的文件弹出一个原生 diff 视图
等你审批 —— 接受 / 拒绝 / 全部接受

这里有个设计我很喜欢：它不会静默改你的代码。所有改动都走 VS Code 原生 diff，你逐块看、逐块点，比那种"改完告诉你改了什么"的方式安全得多。

更关键的是 Checkpoints（检查点）：每次工具调用都会打一个快照，任务跑歪了点一下就能回滚到任意一步。这在模型抽风乱改文件的时候是救命功能。

📷 图 5：diff 审批界面

七、五种模式，别只会用一个

Roo Code 把场景拆成了几个模式，用对了效率翻倍：

模式	定位	使用场景
Code	主力干活	改代码、修 bug、加功能
Architect	只出方案不动手	复杂改造前先拆任务、定架构
Ask	纯问答	读陌生项目、问实现原理，零风险零改动
Debug	排查专用	贴报错日志让它分析定位
Orchestrator	任务分派	大任务拆成子任务并行跑

我摸索出来的稳定工作流是：

Ask 摸底 → Architect 出方案 → Code 落地

新手最常见的错误是上来就用 Code 模式处理整个项目的重构，结果在错误方向上烧掉好几块钱，然后回来骂模型不行。先用 Ask 让它把项目结构讲清楚，再用 Architect 把方案定下来，最后 Code 只负责执行——成功率会高很多。

Orchestrator 要慎用，它是子任务并行，token 消耗涨得非常快，适合"我明确知道要拆成哪几块"的场景。

八、把成本打下来：四个实操技巧

AI 编程助手最容易劝退人的不是能力，而是月底账单。用 DeepSeek 这套组合，成本其实可以控得很低。

1. 吃满上下文缓存

DeepSeek 的缓存命中价是 $0.028/M，比未命中便宜 10 倍。缓存是按前缀匹配的，所以：

一个任务一个会话，别中途开新会话重述背景
项目规则、系统提示这类固定内容放前面，让它稳定命中
同一会话里连续追问，比反复开新会话便宜得多

2. 模型分级，别用杀鸡刀

日常 CRUD、改样式、写注释 → deepseek-chat
算法题、复杂重构、逻辑推理 → deepseek-reasoner

deepseek-reasoner 输出更贵也更慢，拿它写 CRUD 纯属浪费。

3. 用 `.rooignore` 挡住垃圾文件

在项目根目录建 .rooignore，语法和 .gitignore 一样：

node_modules/
dist/
build/
*.log
coverage/
*.min.js
package-lock.json

不挡的话，它搜索时会把这些文件读进上下文，token 哗哗地烧，还容易被压缩代码干扰判断。

4. 精确引用，别整仓投喂

输入框支持 @ 引用文件。与其说"看看这个项目"，不如 @src/api/client.ts 直接点名。上下文里少 90% 的无关内容，效果和成本都是双赢。

九、进阶：给项目写规则

每次对话都重复交代"我们用的是 Vue3 + TS + Pinia"太累了。在项目根目录建：

.roo/rules/rules.md

写清楚技术栈、代码风格、禁止事项，每次请求它会自动带上。例如：

# 项目约定

- 框架：Vue 3 + TypeScript + Pinia，禁止使用 Options API
- 组件一律使用 `<script setup>` 语法
- 网络请求统一走 `src/api/request.ts` 封装，禁止直接用 axios
- 提交前必须通过 `pnpm lint`，不允许 any 类型

规则写得越具体，它瞎改的概率越低。这比任何 prompt 技巧都管用。