波波技术栈
article

VSCode 配置 DeepSeek 完整教程

本文详细介绍了在 VSCode 中配置 DeepSeek 大模型的完整流程。通过安装 Continue 插件并配置 OpenAI 兼容接口,用户可实现智能代码补全、解释与生成。文章涵盖 API Key 获取、插件安装、config.json 参数设置、模型选择及常见问题排查,帮助开发者快速搭建高效的 AI 编程助手环境。

DeepSeek 是一款强大的代码辅助大模型。在 VSCode 中配置 DeepSeek,可以显著提升编码效率,实现智能代码补全、解释、生成及调试功能。目前主流且稳定的配置方式是通过安装支持自定义 API 的 AI 插件(如 ‌Continue‌)来接入 DeepSeek API,因为 DeepSeek 完美兼容 OpenAI 接口协议。

以下是详细的配置步骤:

一、前置准备

  1. 获取 API Key
    • 访问 DeepSeek 开放平台
    • 注册/登录账号,进入“API Keys”页面创建一个新的 API Key。
    • 注意‌:请妥善保存 Key,不要泄露给他人。
  2. 安装 VSCode
    • 确保已安装最新稳定版的 Visual Studio Code。

二、推荐方案:使用 Continue 插件配置

Continue 是一个开源的 AI 编程助手插件,支持接入包括 DeepSeek 在内的多种大模型,配置灵活且免费开源。

1. 安装插件

  1. 打开 VSCode,点击左侧活动栏的 ‌**扩展 (Extensions)**‌ 图标(或按 Ctrl+Shift+X)。
  2. 搜索 Continue
  3. 找到由 ‌Continue‌ 发布的插件,点击 ‌Install‌ 安装。
  4. 安装完成后,VSCode 左侧活动栏会出现 Continue 的图标(通常是一个无限符号 ∞)。

2. 配置 DeepSeek 模型

  1. 点击 Continue 图标打开侧边栏。

  2. 点击侧边栏底部的 ‌**齿轮图标 (Settings)**‌,这将打开 config.json 配置文件。

  3. 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
  4. 保存 config.json 文件(Ctrl+S)。

  5. 在 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-chatdeepseek-coder。2. 查阅 DeepSeek 官方文档确认当前可用的模型 ID。
代码补全不工作 未配置自动补全模型 config.json 中单独配置 tabAutocompleteModel 字段,指向 deepseek-coder 模型。

四、使用建议

  1. 模型选择‌:
    • 日常对话、代码解释、生成‌:使用 deepseek-chat(通常指 DeepSeek-V3 系列),性价比高,速度快。
    • 专业代码补全、复杂算法生成‌:使用 deepseek-coder(如 DeepSeek-Coder-V2),在代码领域表现更优。
  2. 成本控制‌:
    • DeepSeek API 按 Token 计费。在 config.json 中可以设置 contextWindow 限制上下文长度,避免消耗过多 Token。
  3. 隐私安全‌:
    • 避免将敏感数据(如密码、密钥、个人身份信息)发送给公共 API。
    • 如果是企业开发,建议评估数据合规性。

通过以上步骤,你就可以在 VSCode 中顺畅地使用 DeepSeek 提升开发效率了。