python コマンドが「command not found」で実行できない
python: command not found は、python という実行ファイルが PATH に無いと出る。python3 で呼ぶか PATH を通せば直る。
Windows ではストアのエイリアスが横取りすることもある。
公開: 更新:
python --version bash: line 1: python: command not found
python3 --version Python 3.13.5
2026-08-02 に python:3.12 で実際に打って取った出力。検証環境の詳細
要約
python: command not found(Windows では 'python' は、内部コマンド...として認識されていません)は、python という名前の実行ファイルが PATH 上に無い だけのことが多い。
近年の Linux / macOS は python3 しか持たず、Windows ではインストール時に PATH を通し忘れているか、ストアのエイリアスが横取りしている。
まず python3 で動くかを確認する。
実行例
実際に上記の手順を python:3.12(Debian GNU/Linux 13 trixie)環境で動かした。
PATH から /usr/local/bin を除いた状態で python を呼び出すと、終了コード 127 の command not found が再現した。
同ディレクトリを PATH に戻すと、終了コード 0 で正常に実行できた。/usr/local/bin を外したままでも python3 は呼べたが、返ったのは Python 3.13.5 で、command -v python3 が示した /usr/local/bin/python3(3.12.13)とは別の実体だった。
$ command -v python
/usr/local/bin/python$ command -v python3
/usr/local/bin/python3$ python3 --version
Python 3.12.13
python3 のあるディレクトリ: /usr/local/bin
細らせた PATH: /usr/local/sbin:/usr/sbin:/usr/bin:/sbin:/bin$ python --version
bash: line 1: python: command not found
$ echo $?
127$ command -v python && python --version
/usr/local/bin/python
Python 3.12.13
$ echo $?
0$ python3 --version
Python 3.13.5
$ echo $?
0$ command -v python && python --version
/tmp/tmp.NbBuOs2vNb/bin/python
Python 3.12.13
$ echo $?
0— 2026-08-02 時点の出力
検証環境2026-08-02 検証
- 検証日
- 実行環境
python:3.12
この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。
解決策
1. 実体を確認する
python3 --version
which python3 # Windows: where pythonpython3 が動くならエイリアスを作るか、python3 を使えばよい。
実行コマンドの詳細は Python 公式の利用ガイド(新しいタブで開く) にある。
2. PATH を通す
# 例: ~/.local/bin に入っている場合
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrcインストーラの「Add Python to PATH」を入れ忘れた Windows では、再インストール時にそのチェックを入れれば確実に通る。
3. Windows のエイリアスを無効化
設定 ->「アプリ」->「アプリ実行エイリアス」で python.exe / python3.exe をオフ にする。
これが有効だと PATH に Python があってもストアが開くだけで実行されない。
挙動の説明は Python 公式の Windows ガイド(新しいタブで開く) にある。
4. ランチャーやバージョン管理を使う
py -3.12 --versionWindows の py ランチャーは複数バージョンを明示的に呼び分けられる。
Linux/macOS で複数バージョンを使うなら pyenv で pyenv global 3.12 のように固定し、shims が PATH 先頭に来ているか確認する。
よくある原因
- python3 しか存在しない。
近年の OS はpythonを用意せず、python3だけがある。 - PATH が設定されていない。
インストールはされたが、bin / Scripts ディレクトリが PATH に無い。 - Windows のエイリアスが横取りしている。
「アプリ実行エイリアス」のpython.exeが有効で、Microsoft Store を開くだけになる。 - shims や venv が噛み合っていない。
pyenv の shims が PATH 前段に無いか、venv を activate していない。