故障排除

解决 Continue 常见问题的综合指南,包括日志查看、快捷键、网络问题、模型功能及插件配置故障排除。

  1. 查看日志
  2. 尝试最新预发布版本
  3. 下载旧版本
  4. 解决快捷键问题
  5. MCP 服务器连接问题
  6. SSL 证书错误
  7. 查看常见问题解答 (FAQs)

查看日志

要解决许多问题,第一步是读取日志以找到相关的错误消息。请按以下步骤操作:

VS Code

控制台日志

要查看包含额外信息的调试日志,请点击顶部显示“Default levels”(默认级别)的下拉菜单,然后选择“Verbose”(详细)。
  1. MacOS 使用 cmd + shift + P,或者 Windows 使用 ctrl
    • shift + P (Windows)
  2. 搜索并选择“Developer: Toggle Developer Tools”(开发者:切换开发者工具)
  3. 这将打开 Chrome 开发者工具窗口
  4. 选择 Console(控制台)选项卡
  5. 阅读控制台日志

提示词日志 (Continue Console)

要查看提示词日志/分析数据,您可以启用 Continue Console。
  1. 打开 VS Code 设置 (cmd/ctrl + ,)
  2. 搜索设置“Continue: Enable Console”并将其启用
  3. 重新加载窗口
  4. 通过命令面板 (cmd/ctrl + shift + P) 搜索并打开“Continue: Focus on Continue Console View”,即可打开 Continue Console
Continue Console

JetBrains

打开 ~/.continue/logs/core.log 查看 Continue 插件的日志。最新的日志位于文件末尾。
某些与 JetBrains 相关的日志可以通过点击“Help”(帮助)>“Show Log in Explorer/Finder”(在资源管理器/访达中显示日志)找到。

下载最新预发布版本

VS Code

我们不断对 Continue 进行修复和改进,但最新更改通常会在“预发布”版本中保留大约一周,以便我们测试其稳定性。如果您遇到问题,可以通过在 VS Code 中前往 Continue 扩展页面并选择“Switch to Pre-Release”(切换到预发布版本)来尝试,如下所示。
Pre-Release

JetBrains

在 JetBrains 上,“预发布”通过其抢先体验计划 (EAP) 频道进行。要下载最新的 EAP 版本,请启用 EAP 频道:
  1. 打开 JetBrains 设置 (cmd/ctrl + ,) 并转到“Plugins”(插件)
  2. 点击顶部的齿轮图标
  3. 选择“Manage Plugin Repositories...”(管理插件仓库...)
  4. 将 "https://plugins.jetbrains.com/plugins/eap/list" 添加到列表中
  5. 现在您始终可以从插件市场下载最新的 EAP 版本

下载旧版本

如果您尝试了所有方法、报告了错误、确定之前版本可用,且正在等待回复,您可以尝试下载该扩展的旧版本。
对于 VS Code,所有版本均托管在 Open VSX Registry 此处。下载扩展(.vsix 文件)后,您可以按照此处的说明手动安装。
您可以在 JetBrains 插件市场找到旧版本的 JetBrains 扩展,该页面会引导您完成从磁盘安装的过程。

快捷键无法触发

如果您的快捷键没有触发,可能是因为有其他命令占用了 Continue 的快捷键。您可以在 IDE 的配置中检查是否存在此情况,并更改您的快捷键映射。

MCP 服务器连接问题

macOS 上出现 "spawn ENAMETOOLONG" 错误

如果您在 macOS 上使用 MCP 服务器时看到类似 Failed to connect to "<MCP Server Name>" 且伴随 Error: spawn ENAMETOOLONG 的错误,这是因为在生成 MCP 进程时环境配置过大导致的。
解决方法:使用命令的完整路径,而不是依赖 PATH 解析
mcpServers:
  - name: Memory MCP server
    command: /usr/local/bin/npx  # Use full path instead of just "npx"
    args:
      - -y
      - "@modelcontextprotocol/server-memory"
要在您的系统上查找命令的完整路径:
  • 对于 npx:运行 which npx
  • 对于 docker:运行 which docker
  • 对于 uv/uvx:运行 which uvwhich uvx
此问题通常影响拥有大型开发环境的 macOS 用户,目前正在 #7870#6699 中进行跟踪。

SSL 证书错误

如果 Continue 可以连接到您的模型端点但无法验证其 TLS 证书链,您可能会看到 fetch failed 以及以下错误:
  • unable to verify the first certificate(无法验证第一个证书)
  • self signed certificate in certificate chain(证书链中存在自签名证书)
  • certificate verify failed(证书验证失败)
  • CERT_UNTRUSTED(证书不受信任)
这通常发生在连接到使用私有 CA 或不完整证书链的自托管模型、企业代理或内部端点时。

快速修复:信任 CA 包

将该端点的根证书或中间证书添加到您的模型 requestOptions.caBundlePath
models:
  - name: Secure endpoint
    provider: openai
    model: gpt-4.1
    apiBase: https://llm.example.com/v1
    requestOptions:
      caBundlePath: /path/to/ca-chain.pem
如果您的设置需要双向 TLS,请同时配置 requestOptions.clientCertificate。自托管指南在如何设置身份验证中包含了示例。

诊断证书问题

  1. 在 Continue 日志中重现错误,以确认失败的确切主机名。
  2. 使用 curl 直接测试端点
    curl -v https://llm.example.com/v1/models
    
  3. 使用 OpenSSL 检查证书链
    openssl s_client -showcerts -connect llm.example.com:443 -servername llm.example.com </dev/null
    
  4. 将所需的根证书或中间证书保存为 PEM 文件,并将其路径指向 requestOptions.caBundlePath
  5. 在 Continue 中重试之前,先用 curl 验证修复是否有效
    curl --cacert /path/to/ca-chain.pem https://llm.example.com/v1/models
    

常见设置

对于自托管或企业部署,这些选项通常很有帮助:
  • 私有 CA 或企业代理:设置 requestOptions.caBundlePath
  • 双向 TLS:设置 requestOptions.clientCertificate
  • Windows VS Code:如果您的证书通过 Windows 证书存储进行管理,win-ca 扩展可能会有所帮助,但 requestOptions.caBundlePath 仍然是最可靠的选择
作为临时的调试步骤,您可以设置 requestOptions.verifySsl: false 以确认故障是否与证书相关。请勿在正常使用时将其保持禁用状态。

仍然遇到问题?

您可以加入 GitHub Discussions 获取更多支持和讨论。或者,您可以在此处创建 GitHub Issue,提供问题的详细信息,我们会更快地为您提供帮助。