TROUBLESHOOTING GUIDE
Windowsでpythonとpyのバージョンが違うときの直し方
pythonコマンドとpyランチャーが別バージョンを示す理由を整理し、安全に参照先を合わせます。
更新日 2026年9月22日一般的な切り分け手順
結論
pythonはPATH上で最初に見つかった実行ファイルを、pyはPython Launcherの登録情報を使います。故障ではなく、参照ルールの違いが原因です。
まず参照先を確認する
PowerShellで `where.exe python`、`python --version`、`py -0p` を実行します。表示順と実体のパスを比べてください。
- where.exe python でPATHの優先順位を確認
- py -0p でランチャーが把握している全バージョンを確認
- python -m pip --version でpipの所属先も確認
よくある原因
WindowsAppsのエイリアス、古いPythonのPATH、仮想環境の有効化が主な原因です。特に `python` と `pip` を別々に実行すると、異なる環境を参照することがあります。
安全な直し方
まず目的のPythonを決めます。特定プロジェクトではPATH全体を変更せず、venvを作ってその中で固定する方法が安全です。システム全体で変える場合は、アプリ実行エイリアスとユーザーPATHを確認します。
- 不要なターミナルを閉じる
- アプリ実行エイリアスのpython.exeを必要に応じて無効化
- 目的のPythonのScriptsと本体ディレクトリをPATH上位へ
- 新しいPowerShellで再確認
まだ直らない場合
エラーログ全体を診断ツールへ貼り付け、別の原因候補が重なっていないか確認してください。
エラーログを診断