> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Visual Studio Code (VSCode) 故障排查

> 排查 VS Code 扩展问题，包括代理设置、证书错误、API 服务器配置以及聊天回复问题。

<Note>
  我们强烈建议使用原生的 Devin Desktop Editor 或 JetBrains 本地插件，以充分利用其高级 Agent 式 AI 能力和前沿功能。
  VSCode 插件目前处于维护模式。
</Note>

支持 VSCode 1.89 及更高版本。

<div id="gathering-extension-logs">
  # 收集扩展日志
</div>

从 VS Code Extension 1.10.0 起，你可以在 Settings 页面下载 Extension Diagnostics。下载的文件会将一组相关日志和参数汇总为一个文本文件。

*如需获取 VS Code 的完整输出日志：*

1. 打开 Command Palette (`Ctrl/Cmd + Shift + P`，或依次选择 View > Command Palette)

2. 输入 "Show logs"，然后选择 `Developer: Show Logs`

3. 在下拉菜单中，选择 `Extension Host` 和 `Windsurf`

4. 你应该会看到与下图类似的内容：

<Frame>
  <img src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/plugins/troubleshooting-vscode-showlogs.jpg?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=c7eab1a2d7f2d00c003de23ffdbd5ae4" width="2244" height="410" data-path="desktop/assets/plugins/troubleshooting-vscode-showlogs.jpg" />
</Frame>

5. 将右上角显示为 "Extension Host" 的下拉菜单切换为 "Codeium"

6. 导出或复制日志

<div id="known-ide-issues-and-solutions">
  # 已知 IDE 问题及解决方法
</div>

<div id="esplit-is-not-defined">
  ## e.split 未定义
</div>

你使用的 VS Code 版本不受支持，请更新到受支持的版本后重试。你可以在[此处](/zh/windsurf/plugins/compatibility)查看受支持版本列表。

<div id="using-the-wrong-api-server">
  ## 使用了错误的 API Server
</div>

如果用户在其**工作区**设置中更改了 API Server/Portal URL，这会覆盖其用户设置，并可能导致扩展连接到错误的 API server，从而报错。

请确保你的 API Server/Portal URL 设置正确，且未被工作区设置意外覆盖。

<div id="not-seeing-codeium-chat-responses">
  ## 看不到 Codeium Chat 的回复
</div>

如果你尝试向 Codeium Chat 发送消息却看不到回复，请检查是否可以取消当前回复。如果无法取消，则说明回复其实已经完成，只是没有显示出来。这可能是因为 Chat Web Server 与扩展的连接断开了。重新加载 VS Code，并再次打开 Codeium Chat 面板后，应该就能看到这些回复。

<div id="unable-to-read-file-packagejson">
  ## 无法读取文件 .../package.json
</div>

```
Unable to read file .../.vscode/extensions/codeium.codeium-<version>/package.json
```

如果上述错误出现在 Codeium 日志中，请尝试删除扩展文件夹 (.../.vscode/extensions/codeium.codeium-\<version>) 并重新安装该扩展。

如果要手动执行此操作：

1. 打开命令面板 ( CTRL + SHIFT + P )
2. 运行 'Codeium Enterprise: Reset'
3. 在弹出窗口中选择 "Help"
4. 选择 "Show Disabled Extensions"
5. 重新启用你的 Codeium 扩展

<div id="proxy-network-issues">
  ## 代理 / 网络问题
</div>

在 VSCode 的 Codeium 设置中取消勾选 `Detect Proxy`，有时可以解决扩展误将代理用于网络连接的问题。

<div id="certificate-issues">
  ## 证书问题
</div>

如果你遇到以下错误：

```
ConnectError: [internal] unable to get issuer certificate
```

```
[ERROR]: [internal] unable to verify the first certificate
```

```
tls: failed to verify certificate: x509: "<yourdomainurl>" certificate is not standards compliant
```

这表明，Codeium 扩展无法信任与你的企业门户 / API 服务器之间的 TLS 连接，因为它不信任所提供的证书。这意味着，要么是 Codeium 部署提供的证书不受信任，要么是拦截该请求的公司代理提供的证书不受信任。

无论哪种情况，最理想的解决方案都是确保签发此证书的根证书已正确安装在终端用户设备上的适当位置。VS Code 和大多数其他 IDE 都会从操作系统的默认位置加载证书。

你的证书由你本地的 IT 或 Admin 团队签发和管理。请联系他们，协助你在系统上安装所需的证书。

确保在 TLS 终止的位置提供完整的证书链，这一点非常重要。很多时候，如果只提供叶子证书，VS Code 和其他 IDE 就无法验证其真实性，因为它们不知道用于验证叶子证书、且本身又由根证书验证的中间证书。浏览器通常能够绕过这个问题，因为用户很可能之前访问过其他确实提供完整证书链的网站，因此中间证书已被识别并缓存；但像 VS Code 这样的应用并不具备这种优势。

Network Proxy Test VS Code 扩展可用于调试证书问题。