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

# Eclipse 疑难排查

> 排查 Eclipse 插件问题，包括启动相关问题、Chat 界面空白、WebView2 相关问题以及证书错误，并提供基于 Java keystore 的解决方案。

<Note>
  我们强烈建议使用原生 Windsurf Editor 或 JetBrains 本地插件，以充分利用其先进的智能体驱动 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>

日志中可能会出现以下错误来表明此问题：

```
在 <YourDomainURL> 获取扩展版本失败
javax.net.ssl.SSLHandshakeException: PKIX 路径构建失败: sun.security.provider.certpath.SunCertPathBuilderException: 无法找到到请求目标的有效证书路径
```

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

* SaaS 用户需要导入 Codeium 的 GitHub URL
* 自托管（On‑prem）用户需要同时导入其 Codeium Enterprise 域名 URL 以及 Codeium 的 GitHub URL

**注意**：这以 SaaS 用户为例，流程相同。*对于 Enterprise 用户——你的证书由本地 IT 或管理员团队签发和管理。请联系他们，协助在你的系统上安装所需证书。*

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 keystore：（需要在以“Administrator”权限打开的 cmd 提示符中运行）

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

3. 执行以下命令，验证证书已添加到 Keystore：

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

输入 Keystore 密码。

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

5. 在某些情况下，你可能还需要通过编辑 eclipse.ini 文件并添加相应路径，将证书路径作为 VM 参数传递：

```
-Djavax.net.ssl.trustStore="您的证书路径"
```