GoLand 2026.1 Help

パス変数

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

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

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

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

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

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

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

もう 1 つの例は、プロジェクトで使用する アタッチされたディレクトリのパス変数を定義することです。 別のマシンでは、ディレクトリは別の場所に保存されている可能性があります。 アタッチされたディレクトリを含むプロジェクトを別のマシンで共有して使用できるようにするには、パス変数を使用してアタッチされたディレクトリの場所を定義します。

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

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

$USER_HOME$

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

$PROJECT_DIR$

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

パス変数を無視する

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

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

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

  2. GoLand がパス変数と見なすべきでない名前は、 無視される変数 フィールドに追加してください。

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

サンプル: 新しいパス変数を作成する

プロジェクトディレクトリの外部にアタッチされたディレクトリがある場合があります。 このディレクトリはプロジェクトにアタッチされており、このディレクトリへのパスはプロジェクトの .iml ファイルに含まれています。 ただし、このディレクトリの場所は他のコンピューターでは異なる可能性があるため、このパスは絶対パスであってはなりません。 この場合、 PATH_TO_ATT_DIR 変数を作成できます。

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

  2. 追加ボタン をクリックしてください。

  3. 変数の追加 ダイアログで、 PATH_TO_ATT_DIR 変数と、ディスク上のディレクトリの場所を指すその値を入力します。

  4. .iml ファイルをバージョン管理システムで共有します。

  5. チームメイトが VCS からプロジェクトをアップデートした後、 PATH_TO_ATT_DIR の変数値がコンピューター上のライブラリの場所を指すように変更されます。

2026 年 5 月 22 日