Windows で Python を実行しようとして、次のような典型的なエラーに遭遇したことがあるなら、
'python' is not recognized as an internal or external command
ええ、あなただけではありません。WindowsがシステムのPATH内でPythonの実行ファイルを見つけられないと、このイライラが起こります。つまり、「Pythonはインストールしたけど、どこに保存されているか教え忘れた」と言っているようなものです。幸いなことに、この問題を解決するのは通常かなり簡単で、毎回フォルダのフルパスを入力しなくても、どのターミナルからでもPythonとpipを実行できるようになります。これは本当に助かります。
このガイドでは、Pythonを認識させるための確実な方法をいくつかご紹介します。python.org からインストールした場合でも、 Microsoft Storeを利用した場合でも、あるいは単にセットアップ中にミスをした場合でも、コマンドラインを快適に使えるようにするための修正方法がここにあります。さらに、セットアップが正常に動作していることを確認する方法や、よくある間違いを避ける方法についても説明します。
「python」コマンドがブロックされる理由
これは通常、WindowsがPATH環境変数でプログラムを検索するため発生します。Pythonのディレクトリが含まれていない場合、pythonターミナルに入力しても「見つかりません」と表示されます。これは、インストール時にPythonをPATHに追加するチェックボックスをオンにしなかった場合、またはインストール中に何か問題が発生した場合に発生することがあります。
ちょっと奇妙ですが、Windowsはプログラムがどこにあるかを明示的に指示されるのを好みます。そのため、これを修正するには、通常、PATHを更新するか、 Pythonランチャー（py.exe）に頼る必要があります。Pythonランチャーは複数のバージョンをより適切に処理し、毎回環境変数をいじる必要がありません。
Windowsで「Pythonが認識されない」問題を解決する方法
方法 1 – Python インストーラーを使用して PATH に自動的に追加する (最善策)
間違いなく一番簡単です。python.orgからPython をインストールした場合は、セットアップ中に Python を PATH に追加するなど、インストーラーが面倒な作業を代わりに行ってくれます。
- python.orgから最新のインストーラーをダウンロードします。
- インストーラーを実行します。開いたら、「今すぐインストール」をクリックする前に、下部にある「Python 3.x を PATH に追加する」というチェックボックスに必ずチェックを入れてください。Windows ではこのチェックボックスが隠れている場合もあるので、見逃さないようにしてください。
- インストールを完了します。完了したら、インストーラーを閉じます。
- 新しいターミナル（コマンド プロンプトまたは PowerShell）を開き、次のように入力します。
python --version pip --version where python where pip すべてが正しく設定されていれば、Pythonのバージョンとpipのバージョンがエラーなく表示されるはずです。設定によっては、最初の起動時にコマンドが認識されない場合がありますので、ターミナルを閉じて新しいターミナルを開いてみてください。
方法 2 – ユーザー PATH に Python を手動で追加する (管理者は不要)
これは、インストール時にPATHオプションを選択しなかった場合、または何らかの理由でPATHオプションが失われてしまった場合です。ディレクトリは自分で追加できます。Windows環境を少し編集するだけです。ただし、これはシステム上のすべてのユーザーではなく、自分のユーザーアカウントにのみ影響します。管理者権限は必要ありません。
- Win + Rを押して と入力し
sysdm.cpl、Enter キーを押します。すると「システムのプロパティ」ウィンドウが開きます。 - [詳細設定]タブに切り替えて、[環境変数]をクリックします。
- 「ユーザー環境変数」の下で、 「パス」を見つけて選択し、「編集」をクリックします。
- 「新規」をクリックし、次のように Python インストール ディレクトリに貼り付けます。
C:\Users\\AppData\Local\Programs\Python\Python311 また、pip やその他のツールが格納されている Scripts フォルダーも忘れないでください。
C:\Users\\AppData\Local\Programs\Python\Python311\Scripts - 必要に応じて、 「上へ移動」ボタンを使用してこれらのエントリの優先順位を設定します。
- すべてのウィンドウで「OK」をクリックし、ターミナルを再起動します。
- 前と同じコマンドで成功したかどうかを確認します。
python --version pip --version where python where pip 注意：末尾に不要なバックスラッシュを追加するといったよくあるミス（…\Python311まあ、やめておいた方が…\Python311\いいでしょう）を避け、PATH変数に無効なパスが残っていないか確認してください。不適切なエントリを残しておくと、Windowsは容赦なく攻撃を仕掛けてきます。
方法3 – アプリエイリアスを使用してMicrosoft StoreのPythonインストールを処理する
Microsoft Store から Python を入手した場合、多くの場合、アプリ実行エイリアスに依存します。これは OS が設定するショートカットのようなものですが、場合によっては邪魔になったり、PATH と競合したりすることがあります。
- Windows 設定を開き、「アプリ実行エイリアスの管理」を検索します。
python.exeおよびのエントリを探しますpython3.exe。必要に応じてこれらを無効にするか切り替えます。これらにより、クリックするとpythonストアが開いたり、その他の異常が発生したりする場合があります。- さらに、ユーザー PATH に以下が含まれていることを確認してください。
C:\Users\\AppData\Local\Microsoft\WindowsApps 設定が完了したら、端末を再起動してもう一度お試しくださいpython --version。正しい位置に配置されていれば、すぐに認識されます。ただし、再起動後やログアウト/ログイン後にのみ機能する場合があります。
方法4 – Pythonランチャーを使用する（複数のPythonバージョンに最適）
Pythonランチャー（py.exe）は、 python.orgからインストールすると自動的にインストールされます。これにより、PATHをいちいち変更することなく、異なるバージョンのPythonを実行できます。複数のバージョンのPythonを使い分けている場合、これはまさに救世主となるでしょう。
- 呼び出せるかどうか確認してください:
py --version バージョンが返されれば成功です。その後、次のように特定のバージョンのPythonを実行できます。
py -3 py -3.11 py -2.7 仮想環境を作成したいですか？簡単です：
py -3.11 -m venv myenv myenv\Scripts\activate python --version ボーナスヒント：py --list検出されたすべてのPythonランタイムを確認するには、これを使用してください。PATHを毎回編集することなく、複数のプロジェクトを管理するのに最適です。詳細はPythonの公式ドキュメントをご覧ください。
簡単なトラブルシューティングのヒント
まだ何も起きませんか？次のコマンドを実行して再確認してください。
where python where python3 where py pip も検証します:
pip --version where pip PythonがローカルインストールではなくMicrosoft Storeを開く場合は、アプリエイリアスの設定が原因である可能性があります。「設定」→「アプリ」→「アプリと機能」→「アプリと機能」→「アプリ実行エイリアスの管理」で無効にしてください。
もちろん、変更を加えた後はターミナルを完全に閉じて、再度開いてみてください。Windowsが新しい環境変数を認識するには、再起動が必要な場合もあります。
まとめ
「Pythonが認識されません」というエラーのほとんどは、PATHの設定ミスかアプリのエイリアスの問題に起因しています。インストーラーのPATHチェックボックスをオンにしたり、環境変数を手動で編集したり、アプリのショートカットを切り替えたりすることで、通常は問題が解決します。重要なのは、WindowsがPythonの場所を正確に認識できるようにすることです。
すべてが設定されると、コマンドラインでの操作が大幅に楽になります。長いパスを入力したり、Python を 3 度も再インストールしたりする必要がなくなります。