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

# JetBrains のトラブルシューティング

> JCEF エラー、証明書の問題、カスタム ワークスペース、拡張機能の診断など、JetBrains プラグインの問題をトラブルシューティングします。

<div id="supported-versions">
  # 対応バージョン
</div>

バージョン 2022.3 以降。

* JetBrains Fleet または ReSharper はサポート対象外です
* Remote SSH はサポート対象外です。

<div id="gathering-extension-logs">
  # 拡張機能ログの収集
</div>

拡張機能バージョン 1.10.0 以降では、Chat Panel の Settings ページに Extension Diagnostics ボタンがあります。このボタンを使うと、関連するログとパラメーターが自動的に収集され、ダウンロード可能なテキストファイルにまとめられます。

古いバージョンの拡張機能の場合:

1. ログは idea.log ファイルに書き込まれます。このファイルを見つけるには、`Help > Show Log in Finder/Explorer` メニューオプションに移動します

2. ログをエクスポートまたはコピーします

<div id="known-ide-issues-and-solutions">
  # IDE の既知の問題と解決策
</div>

<div id="cascade-not-being-displayed">
  ## Cascade が表示されない
</div>

通常、ログに次のエラーが表示されます。

```
JCEF is not supported in this env or failed to initialize
```

または

```
Internal JCEF not supported, trying external JCEF
```

JCEF は、Cascade を表示するために必要なブラウザーです。これを解決するには、`Help > Find Actions > Choose Java Boot Runtime` に移動し、JCEF が同梱されたランタイムを選択してください。
すでにランタイムに JCEF が同梱されている場合は、レジストリまたはプロパティで JCEF が無効になっている可能性があります。
プロパティを編集します: Help > Edit Custom Properties に移動し、次のフラグを追加して IDE を再起動してください:

```
ide.browser.jcef.enabled=true
```

<div id="certificate-issues">
  ## 証明書の問題
</div>

次のエラーが発生した場合:

```
Failed to fetch extension base URL at <YourDomainURL>
```

```
PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: 
unable to find valid certification path to requested target
```

これは、Codeium 拡張機能が提示された証明書を信頼していないため、Codeium 拡張機能が貴社のEnterpriseポータル / APIサーバーへの TLS 接続を信頼できないことを示しています。つまり、Codeium deployment で提示される証明書が信頼されていないか、リクエストを傍受している企業のプロキシによって提示される証明書が信頼されていない可能性があります。

いずれの場合も、もっとも望ましい解決策は、この証明書に署名したルート証明書が、エンドユーザーのマシン上の適切な場所に正しくインストールされていることを確認することです。JetBrains IDE とその他ほとんどの IDE は、オペレーティングシステムのデフォルトの場所から証明書を読み込みます。

証明書は、社内の IT チームまたは Admin チームによって発行・管理されています。システムに必要な証明書をインストールする際は、そちらにお問い合わせください。

TLS が終端される箇所では、完全な証明書チェーンが提示されていることが重要です。提示されるのがリーフ証明書だけの場合、JetBrains IDE やその他の IDE はその真正性を検証できないことがよくあります。これは、リーフ証明書を検証し、さらにルート証明書によって検証される中間証明書を認識できないためです。ブラウザーでは、この問題を回避できることがよくあります。ユーザーが以前に完全な証明書チェーンを提示する別の Web サイトにアクセスしており、その結果、中間証明書が認識・キャッシュされている可能性が高いためです。しかし、JetBrains IDE のようなアプリケーションにはこの利点がありません。

**注**: JetBrains ファミリー製品の **2024.3** では、IDE が OS の証明書を受け付けられなくなる bug が導入されました ([JetBrains の issue レポート](https://youtrack.jetbrains.com/issue/IJPL-171446/Unable-to-find-valid-certification-path-to-requested-target-exception-in-Settings-Sync-when-proxy-is-used)) 。これを解決するには、users は次のいずれかを実行できます。

* JB 製品を以前のバージョンにダウングレードする
* 2024.3.1 のプレビュー版 (ベータ版) を利用する
* カスタム JVM オプションとして `-Djavax.net.ssl.trustStoreType=Windows-ROOT` を追加する

<div id="custom-workspaces">
  ## カスタムワークスペース
</div>

Cascade の使用時に次のエラーが表示される場合:

```
Cascade cannot access paths without an active workspace
```

これは、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 を再起動します

<div id="enterprise-vs-non-enterprise-behavior">
  ### Enterprise と非 Enterprise での動作の違い
</div>

カスタムワークスペースの動作は、ユーザー種別によって異なります。

<div id="enterprise-users">
  #### Enterprise ユーザー
</div>

Enterprise ユーザーは、ワークスペースのインデックス作成を選択的に制御できます：

* ワークスペースを追加する際、各ワークスペースでインデックス作成を有効にするためのチェックボックスが表示されます
* チェックボックスがオンになっているワークスペースのみがインデックス作成され、Cascade で利用可能になります
* これにより、どのワークスペースでインデックス作成リソースを消費するかを制御できます
* セキュリティ上の理由から、ツール呼び出しはアクティブなワークスペースに制限されます

<div id="non-enterprise-users">
  #### Enterprise以外のユーザー
</div>

Enterprise以外のユーザーでは、ワークスペースのインデックス作成は自動で行われます。

* 追加したワークスペースは、チェックボックスをオンにしなくても自動的にインデックス作成されます
* 追加したすべてのワークスペースは、すぐにCascadeで利用可能になります
* アクティブなワークスペース外でツール呼び出しがブロックされることはありません
* このモデルでは、選択的インデックス作成機能は関係ありません

上記のセットアップ手順を完了すると、Cascade はワークスペースにアクセスでき、通常どおり機能するはずです。

<div id="keyboard-shortcuts-not-working-in-rider-on-windows">
  ## Windows の Rider でキーボード ショートカットが機能しない
</div>

Windows で JetBrains Rider を利用している際に、Cascade で Shift+Enter を押しても改行されない、または Delete キーが機能しない場合は、Rider の Unit Test Tool Window とのキーバインドの競合が原因です。

これは Rider の AI プラグインに影響する既知の問題です。これを解決するには、次の手順に従ってください。

1. `File > Settings` を開いて、JetBrains IDE の Settings を開きます

2. `Keymap` に移動します

3. "Unit Test Tool Window Action" を検索します

4. 競合しているキーバインド (Shift+Enter と Delete) を無効にするか、別のキーに再割り当てします

5. 変更を反映するため、IDE を再起動します