よくある問題のトラブルシューティング。
リモートデスクトップで IntelliJ IDEA がフリーズする場合
XRDP、VNC、X11 Forwarding、NoMachine などでリモートの Linux デスクトップに接続した際に、IntelliJ IDEA がフリーズしたり、白い画面のままになったり、応答しなくなったりする場合は、Java 2D のハードウェアアクセラレーションとリモート環境のグラフィックスドライバーに互換性の問題がある可能性があります。関連する描画オプションの無効化を試してください。
- リモート環境の IntelliJ IDEA で Help > Edit Custom VM Options を選択します。
- ファイルの末尾に次のオプションを追加します。同じオプションが既にある場合は、重複させずに既存の値を変更します。
- ファイルを保存して IntelliJ IDEA を再起動し、画面が正常に操作できるか確認します。
~/.config/JetBrains/<Idea-Version>/idea64.vmoptions にあります。<Idea-Version> は実際のバージョンのディレクトリ名に置き換えてください。
これらのオプションは、OpenGL、XRender、オフスクリーン pixmap 関連の描画を無効にし、リモートのグラフィックス環境との互換性の問題を切り分けるためのものです。
JetBrains Gateway で中国語が四角く表示される場合
JetBrains Gateway でリモートの Linux 開発環境に接続した際に、Qoder の回答に含まれる中国語が四角く表示される場合は、リモートの Linux サーバーに中国語フォントがインストールされ、フォントフォールバックが設定されているか確認してください。
Qoder のテキストには IDE の UI フォントが使われ、コードエディターのフォントとは別です。Inter には中国語の字形が含まれていません。SansSerif は論理フォントで、中国語の表示はシステムのフォントとフォールバック設定に依存するため、エディターのフォントを変更するだけでは解決しない場合があります。
1. リモートサーバーに中国語フォントをインストールする
リモートサーバーのディストリビューションに合わせてコマンドを選択してください。ソフトウェアのインストール権限が必要です。
Red Hat
~/.config/fontconfig/fonts.conf を作成します。既にファイルがある場合は、他の設定を残し、既存の <fontconfig> 要素に以下のルールを追加します。
Inter に中国語のフォールバックフォントを追加し、SansSerif、sans-serif、serif に中国語フォントを指定します。
3. フォントキャッシュを更新して一致するフォントを確認する
Noto Sans CJK SC が見つかることを確認します。fc-match Inter は優先フォントである Inter を返す場合がありますが、それだけで中国語のフォールバックが失敗しているとは判断できません。
4. リモート IDE インスタンスを再起動する
Gateway で接続しているリモート IDE インスタンスを再起動します。再接続後に Qoder に質問し、中国語が正常に表示されるか確認してください。
JetBrains プラグインを更新後に接続できない、または修復に失敗する
- IDE がプラグインの更新を完了するために再起動を求めている場合は、作業を保存してから IDE を再起動してください。
- プロジェクトを再度開きます。Qoder がまだ接続できない場合は、プラグインのツールウィンドウから 問題報告 > トラブルシューティング > ローカルサービスを修復 を開いてください。
- 進行中の Qoder タスクを終了し、修復を開始 を選択してください。このサービスを共有している他の IDE は一時的に切断されます。
- 「ローカルサービスが修復され、起動しました」と表示されたら、チャット画面に戻り、以前失敗したメッセージを再度送信してください。現在のサービスが利用可能であると表示されている場合は、作業を続けてから後で修復を再試行することもできます。
- 古いサービスが停止しない、またはアクセスが拒否された場合。作業を保存してから現在の IDE を終了してください。コンピューター上で IntelliJ IDEA、PyCharm、GoLand などの他の JetBrains IDE、または同じ IDE の他のプロジェクトウィンドウが開いている場合は、それらも終了してください。その後、IDE を 1 つだけ起動し、プロジェクトを 1 つだけ開いて、もう一度修復を実行してください。
- インストールに失敗した場合。ディスクの空き容量と、プラグイン設定の ローカル保存パス への読み書きアクセス権限を確認してください。
- バージョンが一致しない場合。このサービスを共有している IDE の該当プラグインを同じバージョンに更新し、表示されたプロンプトに従って IDE を再起動してください。