IntelliJ IDEA 2026.1 Help

パス変数

パス変数は、絶対ファイルシステムパスのプレースホルダーです。 ハードコーディングされた絶対パスを名前付き変数で置き換えることができます。 これにより、プロジェクト構成を異なるマシン間で移植できるようになります。

このようなリソースは各開発者のコンピューターで異なる場所に存在する場合があるため、ユーザー定義のパス変数は グローバル IDE 設定として保存され、 プロジェクト設定ではありません。 プロジェクトは変数名のみを保存し、各開発者がローカルで値を定義します。 設定が完了すると、パス変数は IntelliJ IDEA のインスタンスで開かれているすべてのプロジェクトで同じ値になります。

パス変数を使用して、 外部ツールや一部の 実行構成のパスとコマンドライン引数を指定できます。 詳細については、 組み込みの IDE マクロ を参照してください。

新しいパス変数を作成して使用する

例: ローカルに保存された JAR ファイルをモジュール依存関係として追加し、この構成を VCS を通じてチームメイトと共有したいとします。

  1. Ctrl+Alt+S を押して設定を開き、 外観 & 振る舞い | パス変数 を選択します。

  2. 追加ボタン をクリックし、ディスク上のファイルを含むターゲットディレクトリを指す新しい変数の名前とその値を入力します。

  3. JAR ファイルを モジュール依存関係として追加します。

  4. .iml ファイルを確認してください。 依存関係はパス変数を使用してそこに追加されます。

チームメンバーが VCS からプロジェクトを更新した後、変数の値を、自分のコンピューター上の必要な JAR ファイルを指すように変更します。

パス変数を受け入れるフィールドおよび構成ファイルでは、この変数を $var_name$ として参照してください。

IntelliJ IDEA には、次の組み込みパス変数もあります。

$USER_HOME$

現在のユーザーのホームディレクトリ。

$PROJECT_DIR$

現在のプロジェクトのルートディレクトリ。

$MODULE_WORKING_DIR$

現在の モジュールのルートディレクトリ

$MODULE_IML_DIR$

現在のモジュールの .iml ファイルがあるディレクトリ。

パス変数を無視する

プロジェクトを開くか更新するたびに、IntelliJ IDEA は未解決のパス変数をチェックします。 IDE がいずれかを検出すると、それらの値を定義するように求められます。 未解決のパス変数を含むファイルまたはディレクトリを使用しない場合は、無視する変数のリストに追加できます。

実行 / デバッグ構成に渡されるプログラム引数がパス変数 (環境変数など) と同じ形式の場合、無視される変数のリストを使用することもできます。

  1. Ctrl+Alt+S を押して設定を開き、 外観 & 振る舞い | パス変数 を選択します。

  2. IntelliJ IDEA がパス変数と見なすべきではない名前を 無視される変数 フィールドに追加します。

  3. 変更を適用するには、 OK をクリックします。

2026 年 3 月 30 日