VSCode Continue 插件 config.yaml 完全配置指南从基础语法到生产级最佳实践本文基于 Continue 官方 v1 Schema 编写覆盖 YAML 配置全字段语法、核心模块深度解析、多场景实战模板与迁移排错指南所有示例均可直接复制使用。文章目录VSCode Continue 插件 config.yaml 完全配置指南从基础语法到生产级最佳实践前言一、配置文件基础1.1 文件位置与打开方式1.2 YAML vs JSON 核心优势二、基础语法强制规范2.1 缩进规则2.2 键值与字符串2.3 列表写法2.4 头部三必填字段三、顶层字段全景总览四、核心模块深度详解4.1 models模型配置最重要4.1.1 roles 角色说明4.1.2 通用模型参数4.1.3 常用 provider 适配器4.2 rules全局行为规则4.3 prompts自定义斜杠命令4.4 context上下文提供程序4.5 autocompleteOptionsTab 补全配置4.6 mcpServersMCP 工具服务五、完整实战配置模板5.1 模板一本地 Ollama 全功能配置5.2 模板二云端 OpenAI 兼容接口5.3 模板三混合部署推荐六、旧版 config.json 迁移指南6.1 核心字段对照表6.2 迁移步骤七、排错与最佳实践7.1 常见错误排查7.2 最佳实践建议八、总结前言Continue 是目前 VSCode 生态中最流行的开源 AI 编码助手之一支持本地大模型、云端 API、代码补全、对话编辑、知识库索引等全链路能力。从 2024 年下半年开始Continue 正式将config.yaml确立为标准配置格式逐步替代旧版config.json。相比 JSON 格式YAML 支持注释、多行字符串、锚点复用更适合复杂配置的维护同时新版配置将所有模型聊天/补全/嵌入/重排统一收敛到models字段通过roles角色区分用途架构更清晰。本文将系统讲解config.yaml的编写规则、字段含义与实战配置帮助你从零搭建一套稳定、高效的 Continue 工作环境。一、配置文件基础1.1 文件位置与打开方式配置文件默认位于用户目录下的.continue文件夹中WindowsC:\Users\你的用户名\.continue\config.yamlMac/Linux~/.continue/config.yaml在 VSCode 中快速打开按下CtrlShiftP调出命令面板输入并执行Continue: Open Config File自动打开当前生效的配置文件优先级说明若目录中同时存在config.yaml和config.jsonYAML 优先级更高JSON 文件将被忽略。1.2 YAML vs JSON 核心优势特性config.yamlconfig.json注释支持支持#行注释完全不支持多行字符串原生支持 /配置复用支持锚点/ 别名*无原生能力可读性缩进层级直观括号嵌套易混乱官方状态当前标准格式已标记废弃二、基础语法强制规范YAML 对格式敏感以下规则必须严格遵守否则会直接解析失败、配置回退默认值。2.1 缩进规则层级缩进必须使用 2 个空格禁止使用 Tab 制表符同级字段左对齐子层级比父层级多 2 空格列表项-属于当前层级后续内容与冒号后内容对齐2.2 键值与字符串冒号后必须跟一个空格key: value禁止key:value普通字符串无需引号包含冒号、#、特殊字符时使用双引号包裹多行字符串使用|保留换行或折叠换行常用于系统提示词# 保留换行适合代码/提示词rule:|第一行内容 第二行内容 第三行内容# 折叠换行适合长段落description:这是一段很长的 描述文本最终会 合并成一行2.3 列表写法两种等价写法短数组推荐行内格式# 分行写法roles:-chat-edit-apply# 行内写法roles:[chat,edit,apply]2.4 头部三必填字段任何合法的config.yaml必须在文件顶部定义以下三个字段缺一不可name:My-Coding-Assistant# 配置名称显示在助手下拉菜单version:1.0.0# 配置版本号自定义维护schema:v1# 配置 Schema 版本固定为 v1三、顶层字段全景总览config.yaml顶层共 9 个核心字段按重要性排序如下字段类型作用是否必填namestring配置名称✅ 必填versionstring配置版本✅ 必填schemastringSchema 版本固定v1✅ 必填modelsarray全部模型定义聊天/补全/嵌入/重排✅ 核心必填rulesarray全局 AI 行为规则替代旧版 systemMessage❌ 可选promptsarray自定义斜杠命令/xxx❌ 可选contextarray上下文提供程序配置❌ 可选autocompleteOptionsobjectTab 自动补全全局参数❌ 可选mcpServersarrayMCP 工具服务Agent 能力❌ 可选docsobject知识库文档索引配置❌ 可选dataobject数据上报与隐私配置❌ 可选四、核心模块深度详解4.1 models模型配置最重要models是整个配置的核心所有大模型能力都在这里定义。每个模型通过roles字段声明其承担的任务角色一套配置可以定义多个模型分别负责不同工作。4.1.1 roles 角色说明一个模型可以同时分配多个角色常用角色如下角色功能chat侧边栏对话聊天主交互模型edit代码内联编辑、重构apply自动应用代码修改到文件autocompleteTab 键代码自动补全embed向量嵌入用于知识库检索rerank检索结果重排序summarize代码、文档摘要生成4.1.2 通用模型参数models:-name:Qwen2.5-Coder-7B# 显示名称自定义provider:ollama# 模型适配器类型model:qwen2.5-coder:7b# 模型标识名apiBase:http://127.0.0.1:11434/v1# API 地址apiKey:sk-xxxxxx# API 密钥本地模型可填占位符roles:[chat,edit,apply]# 模型承担的角色defaultCompletionOptions:# 生成参数temperature:0.6maxTokens:4096topP:0.9requestOptions:# HTTP 请求参数timeout:60000headers:X-Custom-Header:value4.1.3 常用 provider 适配器Continue 支持数十种模型提供商主流场景如下provider 值适用场景备注ollama本地 Ollama 部署模型最常用本地方案openaiOpenAI 官方及所有兼容接口DeepSeek、硅基流动、OneAPI 等均用此anthropicClaude 系列官方 APIgeminiGoogle Gemini 官方 APImistralMistral 官方 APIazureAzure OpenAI 服务4.2 rules全局行为规则rules替代了旧版的systemMessage支持定义多条全局规则所有对话都会附加生效。适合统一代码风格、输出规范、安全约束等。rules:-name:代码输出规范description:全局代码输出约束rule:|1. 所有代码注释使用中文 2. 优先输出简洁、可直接运行的完整代码 3. 关键逻辑必须说明设计思路 4. 不输出无关的客套话和冗余解释-name:安全约束rule:|禁止生成包含硬编码密钥、密码的代码 涉及删除文件、修改系统配置的操作必须给出警告4.3 prompts自定义斜杠命令通过prompts可以定义自己的/命令在聊天框输入即可快速触发支持{{{ input }}}占位符代表选中的代码或输入内容。prompts:-name:reviewdescription:代码审查prompt:|对以下代码进行严格审查指出潜在bug、性能问题、可维护性问题按严重程度排序 {{{ input }}}-name:testdescription:生成单元测试prompt:|为以下代码编写完整的单元测试用例覆盖正常、边界、异常场景 {{{ input }}}-name:commentdescription:添加中文注释prompt:|为以下代码添加清晰的中文关键注释不要修改原有逻辑 {{{ input }}}使用方式在 Continue 聊天框输入/review即可触发。4.4 context上下文提供程序对应旧版的contextProviders控制 AI 能获取哪些额外信息支持代码库、文档、终端输出等上下文源。context:-provider:codebaseparams:nRetrieve:20-provider:docsparams:startOnLoad:true-provider:terminalparams:maxLines:100-provider:diffparams:includeUnstaged:true4.5 autocompleteOptionsTab 补全配置全局控制代码自动补全的行为也可以在单个模型下单独配置覆盖全局。autocompleteOptions:debounceDelay:300# 输入防抖延迟(ms)maxPromptTokens:1024# 补全上下文最大token数onlyMyCode:true# 仅使用自有代码作为上下文disableInFiles:[]# 在指定文件类型禁用补全multilineCompletions:true# 允许多行补全prefixPercentage:0.3# 前缀占比4.6 mcpServersMCP 工具服务支持 Model Context Protocol 工具赋予 AI 执行命令、读取文件、调用外部系统等 Agent 能力。mcpServers:-name:shellcommand:npxargs:[modelcontextprotocol/server-shell]-name:filesystemcommand:npxargs:[modelcontextprotocol/server-filesystem,./]五、完整实战配置模板5.1 模板一本地 Ollama 全功能配置适合完全本地部署、无网络环境使用聊天 补全 嵌入三模型分工。name:Local-Ollama-Fullversion:1.0.0schema:v1models:# 主对话模型7B 量化版负责聊天、编辑、应用-name:Qwen2.5-Coder-7Bprovider:ollamamodel:qwen2.5-coder:7b-q4_K_Mroles:[chat,edit,apply,summarize]defaultCompletionOptions:temperature:0.6maxTokens:4096# 补全模型小参数量低延迟-name:Autocomplete-1.5Bprovider:ollamamodel:qwen2.5-coder:1.5b-q4_K_Mroles:[autocomplete]autocompleteOptions:debounceDelay:250maxPromptTokens:768# 嵌入模型用于代码库检索-name:BGE-M3provider:ollamamodel:bge-m3roles:[embed]rules:-name:代码规范rule:|输出代码使用中文注释优先简洁实现 给出的代码必须可直接运行不输出冗余废话。prompts:-name:reviewdescription:代码审查prompt:|审查以下代码指出bug、性能问题和优化建议 {{{ input }}}autocompleteOptions:onlyMyCode:truemultilineCompletions:true5.2 模板二云端 OpenAI 兼容接口适用于 DeepSeek、硅基流动、通义千问等兼容 OpenAI 协议的云端服务。name:Cloud-API-Configversion:1.0.0schema:v1models:-name:DeepSeek-R1provider:openaimodel:deepseek-reasonerapiBase:https://api.deepseek.com/v1apiKey:sk-xxxxxxxxxxxxroles:[chat,edit,apply]defaultCompletionOptions:temperature:0.7maxTokens:8192-name:Qwen2.5-Coder-32Bprovider:openaimodel:Qwen/Qwen2.5-Coder-32B-InstructapiBase:https://api.siliconflow.cn/v1apiKey:sk-xxxxxxxxxxxxroles:[autocomplete]5.3 模板三混合部署推荐云端大模型负责高质量对话本地小模型负责低延迟补全兼顾效果与速度。name:Hybrid-Configversion:1.0.0schema:v1# 公共配置锚点复用OpenAI兼容参数_api_common:api_commonprovider:openaiapiKey:sk-xxxxxxxxxxxxmodels:# 云端主力模型高质量对话与重构-name:GPT-4o-Mini:*api_commonmodel:gpt-4o-miniapiBase:https://api.openai.com/v1roles:[chat,edit,apply]# 本地补全模型低延迟、不消耗token-name:Local-Autocompleteprovider:ollamamodel:qwen2.5-coder:1.5b-q4_K_Mroles:[autocomplete]# 本地嵌入隐私数据不上云-name:Local-Embedprovider:ollamamodel:nomic-embed-textroles:[embed]六、旧版 config.json 迁移指南6.1 核心字段对照表config.json旧config.yaml新版说明modelsmodels增加roles字段tabAutocompleteModel移入models角色设为autocompleteembeddingsProvider移入models角色设为embedreranker移入models角色设为reranksystemMessagerules数组支持多条规则temperature/maxTokensdefaultCompletionOptions模型级参数slashCommandsprompts数组自定义斜杠命令contextProviderscontext数组name改为provider6.2 迁移步骤在.continue目录新建config.yaml写入头部三字段将所有模型迁移到models数组补充roles角色将systemMessage改写为rules条目将slashCommands改写为prompts条目保存文件Continue 会自动重载验证模型下拉、补全功能正常确认无误后可删除旧config.json七、排错与最佳实践7.1 常见错误排查配置不生效 / 模型不显示检查缩进必须 2 空格禁用 Tab检查冒号后是否有空格查看 VSCode 右下角是否有 YAML 解析报错提示确认模型配置了对应roles聊天模型必须包含chat多行提示词格式错乱多行文本必须使用|或标记文本内容层级比键名多 2 空格同时存在 yaml 和 jsonYAML 优先级更高JSON 不会生效建议只保留一份配置7.2 最佳实践建议角色分离不要让一个模型承担所有角色对话用高质量大模型补全用低延迟小模型量化优先本地部署优先选择 Q4_K_M 量化性价比最高配置版本化维护version字段修改配置时递增便于回滚使用锚点多模型共用参数时用 YAML 锚点和别名*减少重复规则精简rules不宜过多3-5 条核心规则效果最佳过多会稀释主指令密钥安全不要将配置文件提交到 Git敏感密钥建议使用环境变量八、总结config.yaml作为 Continue 的新一代配置格式在可读性、可维护性上相比 JSON 有显著提升。掌握本文的字段规则与配置思路你可以灵活搭建从纯本地到混合云、从单人到团队的各类 AI 编码环境。建议从本文的模板出发根据自己的显卡显存、业务场景、使用习惯逐步调优模型参数与规则最终打造最适合自己的编码助手。