WebStorm 2026.1 Help

パス変数

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

こうしたリソースは開発者ごとに異なる場所に配置される可能性があるため、ユーザー定義のパス変数は プロジェクト設定ではなく、 IDE のグローバル設定として保存されます。 プロジェクトには変数名のみが保存され、各開発者はローカルでその値を定義します。 一度設定すると、パス変数は WebStorm のインスタンスで開いているすべてのプロジェクトで同じ値になります。

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

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

  2. 追加ボタン をクリックし、変数の名前と値を入力し、 OK をクリックして変更を適用します。

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

例: プロジェクトに保存されていないデータソース (CSV ファイルなど) または サードパーティーライブラリの場所を指すパス変数を定義できます。 プロジェクトと共有する実行構成でこのパス変数を使用すると、他のユーザーが自分の環境でこのパス変数の正しい値を定義し、実行構成が確実に機能するようにすることができます。

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

WebStorm には、次の組み込みパス変数もあります:

$USER_HOME$​

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

$PROJECT_DIR$​

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

パス変数を無視する

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

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

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

  2. WebStorm にパス変数と見なしてほしくない名前を 無視される変数 フィールドに追加します。

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

2026 年 6 月 8 日