PyCharm 2026.1 Help

パス変数

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

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

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

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

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

パス変数を使用して、 外部ツールや一部の 実行構成のパスやコマンドライン引数を指定できます。

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

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

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

$USER_HOME$

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

$PROJECT_DIR$

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

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

例: reports.csv ファイルにシステムに保存されているデータを処理する Python スクリプトがあります。 このスクリプトを実行し、VCS を通してこの設定をチームメイトと共有するには、実行 / デバッグ構成を作成します。

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

  2. 追加ボタン をクリックし、新しい変数名(例: DATA_PATH )と、ディスク上のデータファイルがあるターゲットディレクトリを指す値を入力します。

    新しいパス変数を追加する
  3. 実行/デバッグ構成をバージョン管理システムで共有します。

    実行 / デバッグ構成
  4. <project directory>.idea/runConfiguration/<configuration name>.xml ファイルを確認してください:

    パス変数を追加した実行 / デバッグ構成ファイル

    チームメイトが VCS からプロジェクトを更新した後、自分のコンピューター上のデータディレクトリを指すように DATA_PATH 変数値を変更します。

パス変数を無視する

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

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

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

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

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

2026 年 6 月 1 日