> ## 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.

# Eclipse 故障排查

> 排查 Eclipse 插件问题，包括启动异常、聊天界面空白、WebView2 以及可通过 Java 密钥库解决的证书错误。

<Note>
  我们强烈建议使用 Devin Desktop Editor 原生应用或 JetBrains 本地插件，以获得更强大的 agentic AI 能力和最新功能。
  Eclipse 插件目前处于维护模式。
</Note>

<div id="supported-versions">
  # 支持的版本
</div>

4.25+ 版本 (2022-09+)

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

在 Eclipse 中，日志会写入以下路径：

* **Mac/Linux**：\~/.codeium/codeium.log
* **Windows**：`C:\Users\<username>\.codeium\codeium.log`

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

<div id="codeium-isnt-starting">
  ## Codeium 无法启动
</div>

如果 Codeium 无法启动，请查看日志以排查可能的原因 (见上文) 。如果你无法解析该问题，请前往 help.codeium.com 提交工单请求帮助。请务必附上上文提到的日志，以帮助我们的团队尽快排查该问题。

<div id="codeium-chat-shows-an-empty-screen">
  ## Codeium Chat 显示空白页面
</div>

如果你使用的是 Windows 10，则可能需要安装 **WebView2**，以将 Eclipse 的网页渲染器从 Internet Explorer 切换到 Edge。

你可以右键单击 --> `Properties`，查看是否有 Internet Explorer 图标，以此确认是否属于这种情况。

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

此问题可能会在日志中表现为以下错误：

```
Failed to fetch extension version at <YourDomainURL>
javax.net.ssl.SSLHandshakeException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
```

与其他 IDE 不同，Eclipse 不使用操作系统证书存储。你需要将证书导入 Java 密钥库。

* SaaS 用户需要导入 Codeium GitHub URL 的证书
* 自托管 (本地部署) 用户除了需要导入 Codeium GitHub URL 的证书外，还需要导入其 Codeium Enterprise 域名 URL 的证书

**注意**：这是一个面向 SaaS 用户的示例，但流程相同。*对于企业用户，你的证书由本地 IT 或 Admin 团队签发和管理。请联系他们，获取在你的系统上安装所需证书的帮助。*

1. 在浏览器中将 [https://exafunction.github.io/](https://exafunction.github.io/) 的证书导出为 `githubio.cer` 文件

在 Chrome 中：访问该网站，点击挂锁图标，点击 `Connection is secure`，点击 `Certificate is valid`，进入 `Details` 选项卡，点击 `Copy to File...` 按钮

2. 导入到 JDK/JRE 密钥库中： (需要在以 "Administrator" 权限打开的 cmd 提示符中运行)

```
keytool -import -noprompt -trustcacerts -alias codeiumgithub -file githubio.cer -keystore "%JAVA_HOME%/jre/lib/security/cacerts" -storepass changeit
```

3. 执行以下命令，验证证书已添加到密钥库中：

```
keytool -list -keystore "%JAVA_HOME%/jre/lib/security/cacerts" | findstr codeium
```

输入密钥库密码。

4. 重启 Eclipse，并在内置浏览器中打开 marketplace 扩展。系统应会提示你信任未签名内容。

5. 在某些情况下，你可能还需要编辑 `eclipse.ini` 文件，在 VM 参数中添加证书路径：

```
-Djavax.net.ssl.trustStore="path-to-your-certificates"
```