Pythonをインストールしたのに「’python’ は内部コマンドまたは外部コマンドとして認識されません」というエラーが出た経験はありませんか？
それは、Python 環境変数、特に PATH が正しく設定されていないことが原因です。
この記事では、Python利用のための環境変数 PATHを設定する方法を参考に、WindowsでPythonの環境変数を設定する方法を中心に、PATHの役割から確認方法、トラブル対処法までをわかりやすく解説します。
Pythonの環境変数とは？設定が必要な理由を理解しよう
まず環境変数とは、OS全体で共有される設定情報のことです。その中でもPATHは、実行ファイルを探す場所の一覧を管理する環境変数です。
PythonをPATHに登録しておくと、どのフォルダにいてもコマンドプロンプトで次のように入力してPythonを起動できます。
python
もしPATHが通っていないと、上記のコマンドを実行してもPythonが見つからず、エラーになります。
そのため、Pythonを使う前に環境変数のPATH設定を済ませることが重要です。
Pythonインストール時にAdd Python to PATHを選ぶと簡単
Pythonをインストールするとき、初期画面にAdd Python to PATHというチェックボックスがあります。
このオプションにチェックを入れてインストールすると、自動的にPATHが設定されるため、後から手動で環境変数を追加する必要がありません。
ただし、チェックを入れ忘れた場合は自分でPATHを設定する必要があります。以下でその手順を詳しく紹介します。
WindowsでPythonの環境変数を手動で設定する方法
Windowsでの環境変数設定方法は、Python環境変数の設定と取得方法完全ガイド（Windows・Mac・Linux対応）にも詳しくまとめられています。以下は基本的な手順です。
- スタートメニューを開き、「環境変数」と検索
- 「システムの詳細設定の表示」を選択
- 「環境変数(N)…」ボタンをクリック
- ユーザー環境変数の中にある「Path」を選択し、編集をクリック
次に、以下のようなPythonインストール先のパスを追加します。
C:Users<ユーザー名>AppDataLocalProgramsPythonPython312
C:Users<ユーザー名>AppDataLocalProgramsPythonPython312Scripts
追加が終わったらOKを押して保存し、コマンドプロンプトを再起動しましょう。これでPATH設定が反映されます。
環境変数設定後にPythonが使えるか確認する方法
PATH設定が完了したら、コマンドプロンプトを開いて以下を入力します。
python --version
または
python3 --version
成功すると、次のようにPythonのバージョンが表示されます。
Python 3.12.1
もしエラーが出る場合は、以下を確認しましょう：
- PATHのディレクトリが正しく追加されているか
- 古いPythonのパスが残っていないか
- コマンドプロンプトを再起動したか
よくあるトラブルと対処法
① ‘python’ は内部コマンドまたは外部コマンドとして認識されません
→ PATHが設定されていないか、誤ったフォルダを追加している可能性があります。
② 複数バージョンのPythonが競合している
→ 古いバージョンのパスが残っていると、意図しないPythonが起動します。環境変数のPathを確認し、古いディレクトリを削除しましょう。
③ 管理者権限がないため編集できない
→ 管理者としてシステム環境変数を編集するか、ユーザー環境変数を設定すればOKです。
Mac／LinuxでのPATH設定方法・参考
MacやLinuxの場合も、シェルの設定ファイルにPATHを追記してPythonを認識させます。
システム別の設定方法は、Pythonで環境変数を取得・追加・上書き・削除する方法を参考にしてください。
設定手順（bash使用時）
nano ~/.bashrc
以下の1行を追加：
export PATH="$PATH:/usr/local/bin/python3"
保存後、変更を反映させます。
source ~/.bashrc
これでターミナル上でPython3 --versionを実行すると、バージョンが確認できます。
まとめ｜環境変数を設定してPythonをどこからでも使えるようにしよう
- Python 環境変数を設定すれば、どのディレクトリからでもPythonを実行可能
- PATHはインストール時にAdd Python to PATHで自動設定できる
- 設定後は必ず
Python --versionで動作確認を行う
環境変数を正しく設定することで、ターミナルやコマンドプロンプトからPythonをスムーズに操作できます。
これであなたも、Python開発の第一歩を安心して踏み出せます。
