対応バージョン
バージョン 2022.3 以降。- JetBrains Fleet または ReSharper はサポート対象外です
- リモート開発を行うには、別途 Windsurf (Remote Development) プラグイン が必要です。
拡張機能のログの収集
診断情報ファイルをダウンロードするには、次のいずれかの方法を利用します。- Cascade パネルで右上の三点メニューをクリックし、Download Diagnostics をクリックします。
- IDE のメニューで
Tools > Windsurf > Download Windsurf Diagnosticsを選択します。
idea.log ファイルに記録されています。
-
このファイルの場所を確認するには、
Help > Show Log in Finder/Explorerを選択します。 - ログをエクスポートまたはコピーします。
IDE の既知の問題と解決策
Cascade が表示されない
通常、ログに次のエラーが表示されます。Help > Find Actions > Choose Java Boot Runtime に移動し、JCEF が同梱されたランタイムを選択してください。
すでにランタイムに JCEF が同梱されている場合は、レジストリまたはプロパティで JCEF が無効になっている可能性があります。
プロパティを編集します: Help > Edit Custom Properties に移動し、次のフラグを追加して IDE を再起動してください:
証明書の問題
次のエラーが発生した場合:- JB 製品を以前のバージョンにダウングレードする
- 2024.3.1 のプレビュー版 (ベータ版) を利用する
- カスタム JVM オプションとして
-Djavax.net.ssl.trustStoreType=Windows-ROOTを追加する
カスタムワークスペース
Cascade の使用時に次のエラーが表示される場合:-
File > Settings(macOS ではIntelliJ IDEA > Preferences) に移動して、JetBrains IDE の設定を開きます -
Tools > Windsurf Settingsに移動します - Windsurf Settings パネルで、カスタムワークスペース セクションを見つけます。ローカルプラグインでは、Enterprise 以外のユーザーには Tracked Workspaces と表示されます。リモートプラグインでは、このセクションは Enterprise ユーザーにのみ表示されます。
- “Add Workspace” ボタンをクリックして、プロジェクトのワークスペースを追加します
- プロジェクトに適したワークスペース ディレクトリを選択します
- “OK” をクリックして設定を適用します
- 変更を反映するため、IDE を再起動します
Enterprise と非 Enterprise での動作の違い
カスタムワークスペースの動作は、ユーザー種別によって異なります。Enterpriseユーザー
Enterpriseユーザーは、インデックス化するワークスペースを個別に選択できます。- ローカルプラグインでは、各ワークスペースに Tracked チェックボックスがあり、これを選択するとインデックス化が有効になります
- インデックスされるのは、チェックボックスが選択されているワークスペースのみです
- チェックボックスが選択されていないワークスペースはインデックスされませんが、ツール呼び出しでは利用できます
- リモートプラグインには Tracked チェックボックスがなく、カスタムワークスペースはインデックス化されません
- これにより、インデックス化のリソースをどのワークスペースに使うかを制御できます
Enterprise以外のユーザー
Enterprise以外のユーザーでは、ワークスペースのインデックス化は自動で行われます。- 追加したワークスペースは、チェックボックスをオンにしなくても自動的にインデックスされます
- 追加したすべてのワークスペースは、すぐにCascadeで利用可能になります
- このモデルでは、選択的インデックス化機能は関係ありません
ツール呼び出しの制限
Team 設定の Restrict Cascade to workspace は、デフォルトではオフです。レガシーの Team ポータルでは、この設定は Restrict Tool Calls to Workspace (Alpha) という名前になっています。チーム管理者がこの設定をオンにすると、ツール呼び出しで利用できるのはアクティブなワークスペースとカスタムワークスペースのみになります。 これらのステップを完了すると、Cascade があなたのワークスペースにアクセスできるようになります。Windows の Rider でキーボード ショートカットが機能しない
Windows で JetBrains Rider を利用している際に、Cascade で Shift+Enter を押しても改行されない、または Delete キーが機能しない場合は、Rider の Unit Test Tool Window とのキーバインドの競合が原因です。 これは Rider の AI プラグインに影響する既知の問題です。これを解決するには、次の手順に従ってください。-
File > Settingsを開いて、JetBrains IDE の Settings を開きます -
Keymapに移動します - “Unit Test Tool Window Action” を検索します
- 競合しているキーバインド (Shift+Enter と Delete) を無効にするか、別のキーに再割り当てします
- 変更を反映するため、IDE を再起動します

