Pythonにパスを追加する方法｜Windowsの環境変数設定でエラーを解消する手順

Pythonとは？

Pythonは1991年に初めてリリースされたプログラミング言語です。WindowsやmacOS、Linuxなど複数のOSで動作し、開発者はさまざまな用途のコードを記述・開発できます。Web開発、データ分析、AI・機械学習など幅広い分野で活用されており、その柔軟性と充実したサポート体制から、世界で最も広く使われているプログラミング言語のひとつとなっています。

コマンドプロンプトでpythonが認識されない原因

コマンドプロンプトで「python」と入力してもエラーが返され、正しく動作させるには毎回フルパスを指定しなければならないことがあります。これは、コマンドプロンプトが出力を読み込むために「python.exe」の場所を見つけられないために起こる現象です。コマンドプロンプトは環境変数「Path」に登録されたフォルダしか検索しないため、Pythonのインストール先が登録されていないとコマンドを認識できません。

この記事では、この問題を解決するためにPythonへのパスを永続的に追加する方法を解説します。設定を完了すれば、フルパスを指定しなくても「python.exe」を実行できるようになります。

Pythonにパスを追加する手順

パスをあらかじめ追加しておけば、コマンドを実行するたびにパスを指定する必要がなくなります。以下の手順で、Pythonへのパスを永続的に追加しましょう。設定後は「python」と入力するだけでコマンドが実行できるようになります。

1. Windowsキー + Rキーを同時に押して、「ファイル名を指定して実行」を起動します。
2. 「sysdm.cpl」と入力し、「システムのプロパティ」ウィンドウを開きます。
3. 「詳細設定」タブをクリックし、「環境変数」ボタンを選択します。
4. 環境変数ウィンドウが表示されたら、「システム環境変数」（または「ユーザー環境変数」）の一覧から「Path」を選択し、「編集」をクリックします。
5. 「変数値」の入力欄の末尾にカーソルを移動し、「;（セミコロン）」を追加入力します。
6. セミコロンの後にスペースを空けずに、「python.exe」が保存されているフォルダへのフルパスを入力します（例：C:\Users\ユーザー名\AppData\Local\Programs\Python\Python312）。
7. 「OK」をクリックして設定を保存します。
8. これでPythonへのパスが追加されました。コマンドプロンプトで「python」と入力し、バージョン情報が表示されれば、パスが正しく追加されています。

パス追加時の注意点

• Windows 10以降では「編集」をクリックすると一覧形式の編集画面が表示され、「新規」ボタンからPythonのフォルダパスを直接追加することもできます。
• セミコロン（;）は複数のパスを区切るための記号です。既存のパスを削除しないよう、必ず末尾に追加してください。
• 設定を反映させるには、開いているコマンドプロンプトを一度閉じて、再度開き直す必要があります。
• 「python.exe」の場所がわからない場合は、Pythonのインストールフォルダを確認してください。標準設定では「C:\Users\ユーザー名\AppData\Local\Programs\Python\PythonXX」に保存されています。

以上の手順で、コマンドプロンプトのどのディレクトリからでも「python」コマンドを使用できるようになり、Pythonでの開発作業がより快適になります。