【Python】環境変数PATHとは?仕組みと手動設定・確認手順(Windows編)

WindowsでPythonを実行するための環境変数PATHの仕組みと設定手順を解説します。ユーザー環境変数とシステム環境変数の違い、PATH未設定時のpyコマンドによる実行方法、後から手動でPATHを追加する手順まで網羅しています。

はじめに

Pythonをコマンドプロンプトから「python」コマンドで呼び出すには、Windowsの環境変数「PATH」にPythonのインストール先フォルダが登録されている必要があります。

環境変数PATHを設定することで、実行ファイルのフルパスを入力する手間が省け、どの作業フォルダからでもプログラムやパッケージ管理ツールを実行できるようになります。本記事では、環境変数PATHの役割と2種類の環境変数の違い、PATH未設定時の挙動、および後から手動でPATHを確認・追加する手順を解説します。

環境変数PATHの役割とPythonにおける仕組み

インストール時に「Add python.exe to PATH」へチェックを入れる(またはPythonインストールマネージャでPATH追加を実行する)理由は、環境変数にPythonの保存場所を登録し、「python ファイルのパス」という短いコマンドでプログラムを実行できるようにするためです。

環境変数とはOSが管理している設定値の総称で、Windows上で動作する複数のソフトウェアが設定情報を共用するために存在します。その中にある「PATH(Path)」は、コマンドプロンプトなどでコマンド名だけを入力した際に、OSが実行ファイル(.exeファイルなど)を探しに行くフォルダの一覧を定義する変数です。

PythonでPATHに登録されるフォルダの種類

Pythonの環境構築においてPATHに追加される主なフォルダは以下の通りです。

配布形態 登録されるフォルダの役割 デフォルトのフォルダパス例
従来の公式インストーラ(EXE) Python本体(python.exe)の格納先 %LocalAppData%\Programs\Python\Python3xx
従来の公式インストーラ(EXE) 外部ツール(pip.exeなど)の格納先 %LocalAppData%\Programs\Python\Python3xx\Scripts
Pythonインストールマネージャ(MSIX) コマンドエイリアス一式の格納先 %LocalAppData%\Python\bin

ユーザー環境変数とシステム環境変数の違い

Windowsの環境変数には以下の2種類があり、それぞれの「Path」変数に複数のフォルダパスが管理されています。

① ユーザー環境変数:現在Windowsにサインインしているユーザーアカウントごとに個別管理する環境変数です。他のユーザーアカウントには影響せず、管理者権限がなくても設定を変更できます。

② システム環境変数:Windowsシステム全体で管理する環境変数です。そのPCを利用するすべてのユーザーアカウントに共通して適用され、設定の変更には管理者権限が必要です。

2種類の環境変数の比較とPythonの登録先

ユーザー環境変数とシステム環境変数の仕様およびPython導入時の登録先の違いは以下の通りです。

環境変数の種類 適用される範囲 変更に必要な権限 Pythonのパスが登録されるケース
ユーザー環境変数 現在サインイン中のユーザーのみ 標準ユーザー権限で変更可能 通常のインストール(Install Now)やインストールマネージャ使用時
システム環境変数 PC内のすべてのユーザーアカウント 管理者権限(Administrator)が必要 カスタムインストールで全ユーザー向け導入を選択した場合

PATHを設定しなかった場合の挙動と実行方法

インストール時にPATHの追加を行わなかった場合、コマンドプロンプトで「python」と入力してもPythonは起動しません。このときのシステムの挙動と、PATHを追加せずにプログラムを実行する3つの方法は以下の通りです。

Windowsのアプリ実行エイリアスによる挙動

Windows 10およびWindows 11には、PythonがPATHに登録されていない状態で「python」と入力した際、Microsoft Storeのインストール画面を自動的に開く「アプリ実行エイリアス」機能が初期設定で有効になっています。そのため、PATH未設定のまま「python」コマンドを実行すると、エラーメッセージではなくMicrosoft Storeが起動する場合があります。

PATH未設定時にプログラムを実行する3つの方法

PATHを通していない環境でPythonプログラムを実行するには、以下のいずれかの方法を使用します。

① Pythonランチャー(pyコマンド)を使用する:公式インストーラやPythonインストールマネージャでは、PATHの設定有無にかかわらず「py」コマンドが利用できるようにシステムへ構成されます。フルパスを入力しなくても、以下のコマンドでプログラムを実行できます。

② python.exeのフルパスを指定する:Python本体の実行ファイルがある場所を直接指定して実行します。毎回長いパスを入力する手間が発生します。

③ 後から環境変数PATHを手動で追加する:Windowsの設定画面からPythonのフォルダパスを手動で登録し、「python」コマンドを使えるようにします。

環境変数PATHの確認と後から手動で追加する手順

インストール時にPATHのチェックを入れ忘れた場合でも、Windowsの環境変数設定画面から後から手動でPATHを追加できます。

現在のPATH設定を確認する手順

① コマンドプロンプトを起動します。

② 以下のコマンドを入力してEnterキーを押し、OSが認識している「python」コマンドの場所を表示します。

環境変数設定画面からPATHを手動追加する手順

① Windowsのタスクバーにある検索ボックスに「環境変数」と入力し、検索結果から「環境変数を編集」(または「システムのプロパティ」内の「環境変数」ボタン)を開きます。

② 上段にある「(ユーザー名)のユーザー環境変数」の一覧から「Path」を選択し、「編集」ボタンをクリックします。

③ 環境変数名の編集画面が開いたら、右側の「新規」ボタンをクリックします。

④ Pythonをインストールしたフォルダのパス(およびScriptsフォルダのパス)を入力し、「OK」ボタンをクリックして画面を閉じます。

⑤ 新しく起動したコマンドプロンプトで以下のコマンドを入力し、Pythonのバージョンが表示されることを確認します。

まとめ

環境変数PATHは、コマンド入力時にOSが実行ファイルを探すフォルダを指定するための仕組みです。Pythonのインストール時にPATHを追加しておくと、ユーザー環境変数にフォルダパスが登録され、どの場所からでも「python」コマンドでプログラムを実行できるようになります。もしPATHを設定しなかった場合でも、「py」コマンドを使って実行するか、Windowsの環境変数設定画面から後から手動でパスを追加することで対処できます。

関連ページ(もっと学びたい人へ)

Pythonの基礎から応用例まで、以下ページから学ぶことができます。

【Python超入門】基礎から応用例まで幅広く解説
PythonについてPythonは、統計処理や機械学習、ディープラーニングといった数値計算分野を中心に幅広い用途で利用されているプログラミング言語です。他のプログラミング言語と比較して「コードが短くて読みやすい、書きやすい」「ライブラリが豊...

コメント