article
VSCode 配置 DeepSeek 完整教程
本文详细介绍了在 VSCode 中配置 DeepSeek 大模型的完整流程。通过安装 Continue 插件并配置 OpenAI 兼容接口,用户可实现智能代码补全、解释与生成。文章涵盖 API Key 获取、插件安装、config.json 参数设置、模型选择及常见问题排查,帮助开发者快速搭建高效的 AI 编程助手环境。
DeepSeek 是一款强大的代码辅助大模型。在 VSCode 中配置 DeepSeek,可以显著提升编码效率,实现智能代码补全、解释、生成及调试功能。目前主流且稳定的配置方式是通过安装支持自定义 API 的 AI 插件(如 Continue)来接入 DeepSeek API,因为 DeepSeek 完美兼容 OpenAI 接口协议。
以下是详细的配置步骤:
一、前置准备
- 获取 API Key
- 访问 DeepSeek 开放平台。
- 注册/登录账号,进入“API Keys”页面创建一个新的 API Key。
- 注意:请妥善保存 Key,不要泄露给他人。
- 安装 VSCode
- 确保已安装最新稳定版的 Visual Studio Code。
二、推荐方案:使用 Continue 插件配置
Continue 是一个开源的 AI 编程助手插件,支持接入包括 DeepSeek 在内的多种大模型,配置灵活且免费开源。
1. 安装插件
- 打开 VSCode,点击左侧活动栏的 **扩展 (Extensions)** 图标(或按
Ctrl+Shift+X)。 - 搜索
Continue。 - 找到由 Continue 发布的插件,点击 Install 安装。
- 安装完成后,VSCode 左侧活动栏会出现 Continue 的图标(通常是一个无限符号 ∞)。
2. 配置 DeepSeek 模型
-
点击 Continue 图标打开侧边栏。
-
点击侧边栏底部的 **齿轮图标 (Settings)**,这将打开
config.json配置文件。 -
在
models数组中添加 DeepSeek 的配置。由于 DeepSeek 兼容 OpenAI 格式,provider 设置为openai。 **配置示例代码:**json { "models": [ { "title": "DeepSeek Chat", "provider": "openai", "model": "deepseek-chat", "apiKey": "YOUR_DEEPSEEK_API_KEY", "apiBase": "https://api.deepseek.com/v1" }, { "title": "DeepSeek Coder", "provider": "openai", "model": "deepseek-coder", "apiKey": "YOUR_DEEPSEEK_API_KEY", "apiBase": "https://api.deepseek.com/v1" } ], "tabAutocompleteModel": { "title": "DeepSeek Coder", "provider": "openai", "model": "deepseek-coder", "apiKey": "YOUR_DEEPSEEK_API_KEY", "apiBase": "https://api.deepseek.com/v1" } }**关键参数说明:**
title: 显示在插件中的模型名称,可自定义。provider: 必须设置为"openai",因为 DeepSeek 兼容 OpenAI API 协议。model: 填写具体的模型名称,如deepseek-chat(对话/通用任务)或deepseek-coder(代码专用)。apiKey: 填入你第一步获取的 DeepSeek API Key。apiBase: DeepSeek 的官方 API 地址为https://api.deepseek.com/v1。
-
保存
config.json文件(Ctrl+S)。 -
在 Continue 侧边栏顶部的模型选择下拉菜单中,选择你刚刚配置的 "DeepSeek Chat" 或 "DeepSeek Coder"。
3. 验证配置
- 在 Continue 聊天框中输入:“你好,请介绍一下你自己”。
- 如果收到 DeepSeek 的回复,说明配置成功。
- 尝试选中一段代码,右键选择 “Explain Code” 或按快捷键请求解释,测试代码理解能力。
三、常见问题与排查
表格
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 连接超时/失败 | 网络问题或 API 地址错误 | 1. 检查网络是否能访问api.deepseek.com。2. 确认 apiBase 末尾是否包含 /v1。3. 检查防火墙或代理设置。 |
| **认证失败 (401)** | API Key 错误或未生效 | 1. 重新复制 API Key,确保没有多余空格。2. 确认 Key 未在平台上被禁用或删除。3. 检查余额是否充足。 |
| 模型无法识别 | 模型名称填写错误 | 1. 确认模型名称准确,如deepseek-chat 或 deepseek-coder。2. 查阅 DeepSeek 官方文档确认当前可用的模型 ID。 |
| 代码补全不工作 | 未配置自动补全模型 | 在config.json 中单独配置 tabAutocompleteModel 字段,指向 deepseek-coder 模型。 |
四、使用建议
- 模型选择:
- 日常对话、代码解释、生成:使用
deepseek-chat(通常指 DeepSeek-V3 系列),性价比高,速度快。 - 专业代码补全、复杂算法生成:使用
deepseek-coder(如 DeepSeek-Coder-V2),在代码领域表现更优。
- 日常对话、代码解释、生成:使用
- 成本控制:
- DeepSeek API 按 Token 计费。在
config.json中可以设置contextWindow限制上下文长度,避免消耗过多 Token。
- DeepSeek API 按 Token 计费。在
- 隐私安全:
- 避免将敏感数据(如密码、密钥、个人身份信息)发送给公共 API。
- 如果是企业开发,建议评估数据合规性。
通过以上步骤,你就可以在 VSCode 中顺畅地使用 DeepSeek 提升开发效率了。