よくある質問¶

全般¶

どの JetBrains IDE に対応していますか？: このプラグインは LSP をサポートする JetBrains IDE バージョン 2025.3 以降で動作します。IntelliJ IDEA（Ultimate および Community）、WebStorm、CLion、PyCharm、GoLand、Rider などが含まれます。どの IDE を使用しても、すべての機能が利用可能です。
このプラグインは無料ですか？: はい。このプラグインは MIT ライセンスのオープンソースで、無料で使用できます。有料プランやプレミアム機能はありません。
Node.js なしでプラグインは動作しますか？: 部分的に動作します。シンタックスハイライト、コード折りたたみ、ブレースマッチング、Structure View、ファイルテンプレートなどの Native Feature は Node.js なしで動作します。ただし、LSP ベースの機能（コード補完、診断、定義ジャンプ、ホバードキュメント）は Language Server が Node.js 上で動作するため、Node.js が必要です。
Native 機能と LSP 機能の違いは何ですか？: Native 機能 は JFlex レクサーと IntelliJ Platform API を使用してプラグインに直接組み込まれています。高速で常に利用可能であり、外部ツールは不要です。LSP 機能 はバックグラウンドプロセスとして動作する @rescript/language-server によって提供されます。より深いセマンティック理解（型対応の補完、ファイル間ナビゲーション、診断）を提供しますが、Language Server のインストールと起動が必要です。完全な比較表は機能概要を参照してください。

Language Server¶

一部の機能が動作しなくなったのはなぜですか？

通常、Language Server が停止したか、見つからないことを意味します。IDE 下部のステータスバーで ReScript のビルドステータスインジケーターを確認してください。よくある原因:

@rescript/language-server パッケージが削除または更新された
Node.js が PATH に存在しなくなった
プロジェクトが別のディレクトリに移動された

Tools → ReScript → Restart LSP Server から Language Server を再起動してみてください。詳しい解決方法はトラブルシューティングを参照してください。

Language Server を更新するにはどうすればよいですか？

プロジェクト内の npm パッケージを更新してください:

npm update @rescript/language-server

その後、IDE を再起動するか、Tools → ReScript → Restart LSP Server を使用してください。プラグインは更新されたバージョンを自動的に検出します。

グローバルにインストールした Language Server を使用できますか？

はい。プロジェクトローカルのインストールが見つからない場合、プラグインは which（Windows では where）で検出されたグローバルインストールにフォールバックします。ただし、チームメンバー間でバージョンの一貫性を確保するため、ローカルインストールを推奨します。完全な検出順序についてはインストールを参照してください。

ワークフロー¶

プラグインはモノレポに対応していますか？

はい。プラグインは親ディレクトリの node_modules/.bin/rescript-language-server を検索するため、モノレポのルートにインストールされた Language Server はサブディレクトリのプロジェクトから自動的に検出されます。各プロジェクトにはそれぞれの rescript.json 設定ファイルが必要です。

診断（エラー/警告）が表示されないのはなぜですか？

Language Server は型情報を生成するために、初回ビルドが正常に完了する必要があります。ReScript コンパイラを少なくとも一度実行してください:

npx rescript build

ビルドが完了すると、診断が表示されるようになります。IDE 内からビルドウォッチャーを開始することもできます。プロジェクトを開くとプラグインがプロンプトを表示します。詳細はトラブルシューティング — ビルドエラーが表示されないを参照してください。

プラグインの設定はどうすればよいですか？

Settings → Languages & Frameworks → ReScript にアクセスしてください。Language Server のパス、Node.js インタープリター、インレイヒント、reanalyze 統合などを設定できます。利用可能なすべてのオプションについては設定を参照してください。

古いバージョンの ReScript でもプラグインを使用できますか？

プラグインは @rescript/language-server がサポートする任意の ReScript バージョンで動作します。一部の機能（reanalyze サーバーモードなど）は ReScript 12.1.0 以降が必要です。バージョンの互換性については Language Server のドキュメントを確認してください。

バグの報告や機能のリクエストはどうすればよいですか？

GitHub で Issue を作成してください。IDE のバージョン、プラグインのバージョン、ReScript のバージョン、再現手順を記載してください。プラグインにはエラーレポーターも組み込まれており、未処理の例外が発生した場合、事前入力済みの GitHub Issue を開くことを提案します。