> ## 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.
# JetBrains トラブルシューティング
> JetBrains プラグインで発生する JCEF エラー、証明書の問題、カスタムワークスペース、拡張機能の診断などの問題のトラブルシューティング方法を説明します。
# 対応バージョン
バージョン 2022.3 以上。
* JetBrains Fleet および ReSharper には対応していません
* Remote SSH には対応していません。
# 拡張機能のログ収集
拡張機能バージョン 1.10.0 以降では、Settings ページの Chat パネルに Extension Diagnostics ボタンが追加されています。このボタンを使うと、関連するログとパラメータが自動的に収集され、ダウンロード可能なテキストファイルにまとめられます。
拡張機能の旧バージョンの場合:
1. ログは idea.log ファイルに出力されます。このファイルを見つけるには、`Help > Show Log in Finder/Explorer` メニューオプションを開きます
2. ログをエクスポートするか、コピーします
# 既知の IDE の問題と対処法
## Cascade が表示されない
通常、ログには次のエラーが記録されます。
```
この環境ではJCEFがサポートされていないか、初期化に失敗しました
```
または
```
内部JCEFはサポートされていません。外部JCEFを試行中
```
JCEF は Cascade を表示するために必要なブラウザコンポーネントです。対処するには、`Help > Find Actions > Choose Java Boot Runtime` を開き、JCEF が同梱されたランタイムを選択してください。
すでにランタイムに JCEF が同梱されている場合は、レジストリやプロパティで JCEF が無効化されている可能性があります。
プロパティを編集します: Help > Edit Custom Properties を開き、次のフラグを追加して IDE を再起動してください:
```
ide.browser.jcef.enabled=true
```
## 証明書の問題
次のようなエラーが発生した場合:
```
Failed to fetch extension base URL at
```
```
PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException:
unable to find valid certification path to requested target
```
これは、Codeium 拡張機能が Enterprise ポータル / API サーバーへの TLS 接続を信頼できていないことを示しており、その原因は提示されている証明書を信頼していないためです。これは、Codeium デプロイメントが提示している証明書が信頼されていないか、リクエストを中継している社内プロキシが提示している証明書が信頼されていないことを意味します。
いずれの場合でも、最も望ましい解決策は、その証明書に署名したルート証明書が、エンドユーザーのマシン上の適切な場所に正しくインストールされていることを確認することです。JetBrains IDE とほとんどの他の IDE は、オペレーティングシステムのデフォルトの場所から証明書を読み込みます。
証明書は、社内の IT 担当または管理チームによって発行および管理されています。必要な証明書をシステムにインストールする作業については、彼らに問い合わせてサポートを受けてください。
TLS が終端されている場所から、完全な証明書チェーンが提示されていることが重要です。多くの場合、リーフ証明書のみが提示されていると、JetBrains IDE やその他の IDE は、そのリーフ証明書を検証する中間証明書の存在を認識していないため、その正当性を検証できません。中間証明書はリーフ証明書を検証し、さらにルート証明書によって検証されます。ブラウザは、多くの場合この問題を回避できます。というのも、ユーザーは完全な証明書チェーンを提示する別の Web サイトにアクセスしたことがあり、その際に中間証明書が認識されキャッシュされている可能性が高いからです。しかし、JetBrains IDE のようなアプリケーションにはこの利点がありません。
**注意**: JetBrains ファミリー製品 **2024.3** では、IDE が OS の証明書を受け入れられなくなるバグが導入されました（[JetBrains issue report](https://youtrack.jetbrains.com/issue/IJPL-171446/Unable-to-find-valid-certification-path-to-requested-target-exception-in-Settings-Sync-when-proxy-is-used) を参照）。これを解決するために、ユーザーは以下のいずれかを行うことができます。
* JetBrains 製品を以前のバージョンにダウングレードする
* 2024.3.1 プレビュー版（ベータ版）を使用する
* カスタム JVM オプションとして `-Djavax.net.ssl.trustStoreType=Windows-ROOT` を追加する
## カスタムワークスペース
Cascade を使用していて、次のエラーが表示される場合があります：
```
Cascadeはアクティブなワークスペースがないとパスにアクセスできません
```
これは、Cascade が正常に動作するためにカスタムワークスペースへのアクセスが必要であることを示しています。これを解決するには、次の手順を実行します。
1. `File > Settings`（macOS の場合は `IntelliJ IDEA > Preferences`）に移動して、JetBrains IDE の設定を開きます
2. `Tools > Windsurf Settings` に移動します
3. Windsurf Settings パネルで、下部にある "Custom Workspaces" セクションを探します
4. "Add Workspace" ボタンをクリックして、プロジェクト用のワークスペースを追加します
5. プロジェクトに対応するワークスペースディレクトリを選択します
6. 設定を反映するために "OK" をクリックします
7. 変更を反映させるには IDE を再起動します
### Enterprise と Non-Enterprise の挙動の違い
カスタムワークスペースの動作は、ユーザータイプによって異なります。
#### Enterprise ユーザー
Enterprise ユーザーは、ワークスペースのインデックス化を選択的に管理できます:
* ワークスペースを追加する際、各ワークスペースでインデックス化を有効にするためのチェックボックスが表示されます
* チェックボックスを有効にしたワークスペースのみがインデックス化され、Cascade で利用可能になります
* これにより、どのワークスペースがインデックス化リソースを消費するかを制御できます
* セキュリティ上の理由から、ツールの呼び出しはアクティブなワークスペースに制限されます
#### 非Enterpriseユーザー
非Enterpriseユーザーでは、ワークスペースは自動的にインデックス化されます:
* 追加したワークスペースは、チェックボックスの操作なしで自動的にインデックス化されます
* 追加したすべてのワークスペースは、即座に Cascade で利用可能になります
* アクティブなワークスペース外でも、ツール呼び出しがブロックされることはありません
* このモデルでは、選択的インデックス化機能は対象外です
上記のセットアップ手順を完了すると、Cascade がワークスペースにアクセスでき、正常に動作するはずです。
## Windows の Rider でキーボードショートカットが機能しない
Windows 上で JetBrains Rider を使用していて、Cascade で Shift+Enter で新しい行が作成されなかったり、Delete キーが機能しない問題が発生する場合、これは Rider の Unit Test Tool Window とのキーバインド競合が原因です。
これは Rider の AI プラグインに影響する既知の問題です。解決するには、次の手順を実行してください。
1. `File > Settings` に移動して JetBrains IDE の設定を開きます
2. `Keymap` に移動します
3. "Unit Test Tool Window Action" を検索します
4. 競合しているキーバインド（Shift+Enter と Delete）を無効化するか再割り当てします
5. IDE を再起動して変更を反映させます