Continue 自动补全设置与配置指南

关于在 Continue 中设置和配置自动补全的逐步指南,涵盖 Codestral、Ollama 和 IDE 设置。

自动补全模型推荐

模型作用最佳开源模型最佳闭源模型备注
自动完成闭源模型略优于开源模型
如果您想要获得最佳的自动补全体验,我们建议使用 Codestral,它可以通过 Mistral API 获取。请获取 API 密钥并将其添加到您的配置中。
Codestral API 密钥:Codestral 的 API 密钥与通用的 Mistral API 密钥不同。如果您正在使用 Codestral,通常需要一个 Codestral API 密钥;但如果您是作为团队共享密钥,或者希望使用 api.mistral.ai,请确保在 tabAutocompleteModel 中设置 "apiBase": "https://api.mistral.ai/v1"

如何使用 Ollama 在 Continue 中设置自动补全(本地模型)

如果您想在本地运行自动补全模型,我们建议使用 Ollama。首先,从 此处 下载最新版本的 Ollama。然后,运行以下命令来下载我们推荐的模型:
ollama run qwen2.5-coder:1.5b
接着,将模型添加到您的配置中。
模型下载完成后,您应该会在 VS Code 中看到补全提示。
通常不建议使用“思维链”(thinking-type)模型,因为它们的生成速度较慢,不适合需要高响应速度的场景。
但是,如果您使用任何支持思维链开关的模型,可以通过关闭思维模式来配置这些模型用于自动补全功能。
例如:
name: My Config
version: 0.0.1
schema: v1

models:
  - name: Qwen3 without Thinking for Autocomplete
    provider: ollama
    model: qwen3:4b # qwen3 is a thinking-switchable model
    roles:
      - autocomplete
    requestOptions:
      extraBodyProperties:
        think: false # turning off the thinking
然后,在 Continue 面板中,选择此模型作为自动补全的默认模型。

Continue 中的自动补全配置选项

Continue Mission Control 上提供的自动补全模型

hub 上探索自动补全模型配置

在 Continue 插件中自定义自动补全用户设置

可以在 IDE 插件的“用户设置页面”中配置以下自动补全设置:
  • Multiline Autocompletions(多行自动补全):控制自动补全的多行提示。可设置为 alwaysneverauto。默认为 auto
  • Disable autocomplete in files(在文件中禁用自动补全):以逗号分隔的 glob 模式列表,用于在匹配的文件中禁用自动补全。例如:**/*.md, **/*.txt

如何使用 config.json 配置自动补全(已弃用格式)

YAML 配置

config.yaml 格式提供了使用 autocompleteOptions 字段进行模型级配置的功能。详情请参阅 YAML 参考
models:
  - name: Codestral
    provider: mistral
    model: codestral-latest
    roles:
      - autocomplete
    autocompleteOptions:
      disable: false
      maxPromptTokens: 1024
      debounceDelay: 250
      modelTimeout: 150
      maxSuffixPercentage: 0.2
      prefixPercentage: 0.3
      onlyMyCode: true

JSON 配置(已弃用)

config.json 配置格式通过 tabAutocompleteOptions 提供配置选项。详情请参阅 JSON 参考

Continue 自动补全常见问题与故障排除

我想要更好的补全效果,应该使用 GPT-5 吗?

令人惊讶的是,答案是不需要。我们建议用于自动补全的模型都经过了特定提示词格式的训练,这使它们能够响应代码补全请求(点击此处查看此类提示词示例)。一些顶尖的商用模型(如 GPT-5 或 Claude)并未针对此提示词格式进行训练,因此它们生成的补全内容可能无用。幸运的是,卓越的自动补全并不需要超大规模的模型。大多数顶尖的自动补全模型参数量不超过 10B,超过此规模并不能显著提升性能。

自动补全无法工作 – 如何修复

按照以下步骤确保一切设置正确:
  1. 确保已勾选“Enable Tab Autocomplete”设置(在 VS Code 中,点击状态栏中的“Continue”按钮即可切换;在 JetBrains 中,请前往 Settings -> Tools -> Continue)。
  2. 确保已下载 Ollama。
  3. 运行 ollama run qwen2.5-coder:1.5b 以验证模型是否已下载。
  4. 确保禁用了其他任何补全提供程序(例如 Copilot),因为它们可能会产生干扰。
  5. 检查日志输出以发现潜在错误:在 VS Code 中使用 cmd/ctrl + shift + P -> "Toggle Developer Tools" -> "Console" 选项卡;在 JetBrains 中查看 ~/.continue/logs/core.log。
  6. 检查 VS Code 设置,确保 "editor.inlineSuggest.enabled" 设置为 true(使用 cmd/ctrl + , 然后搜索该项并勾选)。
  7. 如果问题仍然存在,请在我们的 GitHub Discussions 中告诉我们,我们将尽快为您提供帮助。

为什么我的补全只有单行?

为了确保您收到多行补全,可以在 tabAutocompleteOptions 中设置 "multilineCompletions": "always"。默认值为 "auto"。如果您发现仍然只有单行补全,这可能是因为某些模型在从文件中间开始时倾向于生成较短的补全。您可以尝试暂时将光标下方的文本移出当前文件,或者切换到更大的模型。

如何为自动补全建议设置触发快捷键

在 VS Code 中,如果您不想自动显示建议,可以:
  1. 在 VS Code 设置中将 "editor.inlineSuggest.enabled": false 设置为禁用自动建议。
  2. 打开“键盘快捷方式”(cmd/ctrl+k, cmd/ctrl+s)并搜索 editor.action.inlineSuggest.trigger
  3. 点击“+”图标添加新的快捷键。
  4. 按下您想要用于触发建议的组合键(例如 cmd/ctrl + space)。
  5. 现在,每当您想要查看建议时,只需按下您的快捷键(例如 cmd/ctrl + space)即可手动触发建议。

自动补全中单行接收的快捷键

这是 VS Code 的内置功能,但比较隐蔽。请按照这些设置在 VS Code 中重新分配键盘快捷方式:
  1. 按下 Ctrl+Shift+P,输入命令:Preferences: Open Keyboard Shortcuts,进入快捷键设置页面。
  2. 搜索 editor.action.inlineSuggest.acceptNextLine
  3. 将快捷键设置为 Tab
  4. 将触发条件 (when) 设置为 inlineSuggestionVisible && !editorReadonly。这将使多行补全(包括 Continue 的补全以及来自 VS Code 内置或其他插件的代码片段)依然有效,并且您会看到多行补全。但是,Tab 键每次只会填入一行。任何多余的代码都可以用 Esc 取消。如果您需要应用所有代码,只需多次按下 Tab 即可。

如何在 Continue 中关闭自动补全(VS Code 和 JetBrains)

VS Code

点击屏幕右下角状态栏中的“Continue”按钮。勾选标记将变为“取消”符号,您将不再看到补全。您可以再次点击以重新开启。
或者,打开 VS Code 设置,搜索“Continue”并取消勾选“Enable Tab Autocomplete”。
您也可以使用默认快捷键直接关闭自动补全:按住 ctrl/cmd + K(保持按住 ctrl/cmd),然后按下 ctrl/cmd + A。这将直接关闭自动补全,无需导航至设置页面。

JetBrains

打开 Settings -> Tools -> Continue 并取消勾选“Enable Tab Autocomplete”。

反馈

如果您关闭了自动补全,我们很乐意听取您的改进建议!请在我们的 GitHub Discussions 中告诉我们或在 GitHub 上提交 issue。