本文面向AI教学与开发场景，系统讲解DeepSeek接入VSCode的选型、密钥、插件配置与排错，帮助读者稳定获得智能编码与问答能力。 在 AI 指导老师的日常工作中，VSCode 是演示代码、批改作业和讲解工程结构的主要工具，DeepSeek 则凭借 OpenAI 兼容接口、中文理解能力和较低调用成本成为常见模型选择。把 DeepSeek 接入 VSCode 并不是安装一个扩展就结束，它涉及账号准备、API 密钥、模型端点、插件参数、网络代理和上下文策略等环节。下面按照实际落地顺序展开，覆盖 Continue、Cline、Roo Code 等常见插件，并给出教学场景中的稳定运行方法。
1. 环境准备与工具选型
接入之前要明确 VSCode 版本与运行环境。建议使用 1.85 以上版本，扩展市场中的 Continue、Cline、Roo Code 都能正常安装。VSCode 本身不需要 Node.js 才能运行，但部分插件在执行本地命令、安装依赖或运行测试时会调用系统终端，因此教学机器上最好准备 Node.js 18 以上、Python 3.10 以上和 Git，避免演示到一半因环境缺失中断。DeepSeek 侧需要在 platform.deepseek.com 注册账号，完成手机号或邮箱验证，并在 API Keys 页面创建密钥。这个密钥只在创建时完整显示一次，应立即保存到密码管理器或系统环境变量，不要直接粘贴到课堂共享的配置文件里。
工具选型决定后续配置。Continue 适合聊天、代码解释、单元测试生成和行内补全，配置集中在 config.json，支持 OpenAI 兼容接口，适合需要精细控制提示词和上下文的老师。Cline 和 Roo Code 更接近自主编码代理，可以读取工作区、修改文件、运行终端命令，适合演示从需求到代码的完整流程，但教学时要关闭自动执行或保持人工确认。Aider 以终端工作，适合仓库级重构和 Git 提交辅助。若课堂只讲代码问答，Continue 的配置成本最低；若要展示代理式开发，Cline 与 Roo Code 更直观，但权限和成本控制要更严格。
网络与安全准备同样不能省略。国内网络通常可以直连 api.deepseek.com，但学校机房、企业网络或 VPN 环境可能要求代理。VSCode 可在设置中搜索 http.proxy 填入代理地址，部分扩展还会读取 HTTPS_PROXY 与 NO_PROXY 环境变量。若代理只对终端生效，插件请求仍可能失败，需要把 api.deepseek.com 加入直连名单或确认代理支持 SSE 长连接。教学项目应使用独立 API 密钥并设置额度上限，避免学生误用或密钥泄露导致账单失控。工作区也建议使用示例仓库，不要把包含学生隐私、考试答案或生产密钥的目录直接交给代理插件。
2. API密钥与DeepSeek模型配置
DeepSeek 的 API 设计与 OpenAI 兼容，这使 VSCode 插件接入变得直接。创建密钥后，需要在插件中填写 Base URL 与模型 ID。Base URL 通常写 ，用于 OpenAI 兼容模式；如果插件说明要求不带 v1，也可以写 。聊天补全路径为 /chat/completions，流式响应通过 server-sent events 返回。模型 ID 主要有 deepseek-chat 与 deepseek-reasoner，前者对应通用对话和代码生成，后者对应更强的推理链，适合复杂调试和算法讲解。模型 ID 区分大小写，写成 DeepSeek-Chat 或 deepseek_chat 都可能返回 400 或 404。
参数设置要结合教学任务。代码补全和生成建议把 temperature 设在 0 到 0.3，减少随机性；代码解释、概念问答和出题可以设在 0.3 到 0.7，让表达更自然。max_tokens 不宜过大，课堂演示常用 1024 到 4096，复杂重构再提高。DeepSeek 按输入与输出 token 计费，缓存命中的输入价格更低，因此重复使用的系统提示词和固定上下文有助于降低成本。若使用 deepseek-reasoner，推理过程会消耗额外 token，适合难题拆解，不适合每轮闲聊。官方控制台会展示用量与余额，教学前应确认额度充足，并设置告警。
密钥管理要避免硬编码。Continue 的 config.json 可以写 apiKey: “${{ secrets.DEEPSEEK_API_KEY }}” 之类的环境变量引用，或使用插件提供的密钥存储。Cline 与 Roo Code 在设置页填写 API Key 后会保存在 VSCode 的 SecretStorage 中，比明文 JSON 更安全。不要在截图、录屏或公开仓库中暴露密钥，一旦泄露应立即在控制台吊销并重新生成。企业或学校可让每位老师使用独立子密钥，便于审计和限额。配置完成后，可以先用 curl 或 Postman 调用一次 /chat/completions，确认密钥、端点与模型 ID 都能返回结果，再回到 VSCode 排查插件层问题。
3. 插件连接与验证
以 Continue 为例，在 VSCode 扩展面板搜索 Continue 并安装，重载窗口后左侧会出现 Continue 图标。打开配置文件 config.json，在 models 数组中添加一个 provider 为 openai 的模型，model 填 deepseek-chat，apiBase 填 ，apiKey 填环境变量引用或密钥，contextLength 可填 64000。保存后回到 Continue 侧边栏，如果模型下拉列表出现 deepseek-chat，说明配置已被识别。此时可以选中一段代码，输入“解释这段代码的执行流程”，观察是否以流式返回中文解释。若没有响应，先看 VSCode 输出面板中的 Continue 日志，再检查 JSON 是否有多余逗号或引号。
Cline 与 Roo Code 的配置路径不同，但核心字段一致。在设置中选择 API Provider 为 OpenAI Compatible，Base URL 填 ，API Key 填入控制台生成的密钥，Model ID 填 deepseek-chat 或 deepseek-reasoner。保存后新建任务，输入一个只读请求，例如“阅读当前文件并总结函数职责”，确认代理能读取工作区但不会自动改文件。Cline 默认会请求执行终端命令和写入文件，教学演示中应保持人工确认，或者把自动执行选项关闭。Roo Code 提供多种模式，可以把架构讨论、代码编写和调试分成不同模式，减少误操作。
连接验证要覆盖成功与失败两类路径。成功时，插件应能返回带代码块的中文内容，并支持多轮上下文。失败时，401 通常表示密钥错误或未生效，404 多为 Base URL 路径错误，429 表示限流或余额不足，400 常见于模型 ID 错误或参数越界，超时则与代理、DNS 或长连接有关。VSCode 设置中的 http.proxy 会影响扩展网络请求，但部分插件使用独立 HTTP 客户端，需要同时配置环境变量。若公司代理替换证书，还要把根证书加入系统信任链。验证通过后，建议保存一份可复用的配置模板，方便在不同教学机器上快速部署。
4. 教学场景调优与故障排查
AI 指导老师使用 DeepSeek 接入 VSCode 时，提示词设计比插件选择更影响教学效果。可以在系统提示中设定角色，例如“你是一名编程助教，用中文解释，先分析思路，再给关键代码，不直接替学生完成全部作业”。批改作业时，让学生先把代码和报错贴入对话，再要求模型指出错误类型、最小复现和修改方向。讲解算法时，可以让 deepseek-reasoner 展示推理步骤，但提醒学生核验结论。生成练习时，要求模型给出难度、输入输出示例和隐藏测试点，并让它在课堂现场运行单元测试，形成从提问到验证的闭环。
上下文与成本需要持续管理。VSCode 插件通常支持 @File、@Folder 或 @Codebase 引用，但一次放入过多文件会迅速消耗 token，并可能稀释关键信息。教学演示应只引用当前模块、接口定义和测试文件，长会话要定期新建，避免把无关历史带入。日常问答和代码补全用 deepseek-chat 即可，复杂调试、架构权衡和算法推导再用 deepseek-reasoner。若发现费用上升，可以检查是否重复上传大文件、是否开启自动补全、是否让代理反复读取整个仓库。设置 max_tokens、使用缓存命中、统一系统提示词，都能在保持效果的同时降低调用成本。
故障排查要按层定位。插件层先看扩展日志和配置 JSON，模型层用最小请求验证密钥与模型 ID，网络层检查代理、DNS、证书和 SSE 长连接，账户层确认余额、限流和实名状态。遇到 429 时降低并发并等待配额恢复，遇到 401 时重新生成密钥并更新插件，遇到 404 时确认 Base URL 是否带 /v1，遇到响应中断时把 timeout 调大并检查代理是否缓冲流式数据。VSCode 与插件更新后，旧配置可能因字段变化失效，需要重新对照官方文档。数据隐私方面，学生姓名、学号、私有仓库地址和未公开试题都应脱敏后再发送，敏感项目可以使用本地模型或关闭云端上下文。完成这些调优后，DeepSeek 在 VSCode 中就能成为可授课、可复用、可审计的教学助手。
