できない.dev

pyenv「pyenv: python: command not found」の原因と直し方

pyenv: python: command not found は、今選ばれている版にそのコマンドが無いと出る。
pyenv global か pyenv local で、一覧に出た版を選べば直る。
pip で入れたツールは今の版に入れ直す。

公開: 更新:

症状できない · exit 127
pytest --version
…
pyenv: pytest: command not found
The `pytest' command exists in these Python versions:
  3.11.18
解決後できた · exit 0
pyenv global system 3.11; python --version; pytest --version
Python 3.12.16
pytest 9.2.0

2026-11-12 に python:3.12(Python 3.12.16 / Git 2.47.3) で実際に打って取った出力。検証環境の詳細

要約

pyenv: python: command not found は、pyenv のどれかの版にそのコマンドはあるのに、今選ばれている版には無いと出る。
次の行の一覧に出た版を pyenv global か pyenv local で選べば直る。
pip や pytest でも、名前が変わるだけで同じ形になる。

pyenv: python: command not found
 
The `python' command exists in these Python versions:
  3.13.18
 
Note: See 'pyenv help global' for tips on allowing multiple
      Python versions to be found at the same time.

先頭が pyenv: なら、pyenv の shim までは届いている。
bash: pytest: command not found のようにシェルの名前で始まるなら、どの版にもそのコマンドが入っていないか、shim が PATH に入っていない。

実行例

pyenv で 3.11 に入れた pytest を、global が system の状態で呼ぶと、pyenv: pytest: command not found で終了コード 127 になる。
pyenv whence で入っている版を調べ、pyenv global で 3.11 を選ぶと、同じ pytest --version が 0 で通る。

$ pyenv versions
* system (set by /root/.pyenv/version)
  3.11.18
$ pytest --version
pyenv: pytest: command not found
 
The `pytest' command exists in these Python versions:
  3.11.18
 
Note: See 'pyenv help global' for tips on allowing multiple
      Python versions to be found at the same time.
$ echo $?
127
$ pyenv whence pytest
3.11.18
$ pyenv global 3.11; pytest --version
pytest 9.2.0
$ echo $?
0
$ pyenv global system 3.11; python --version; pytest --version
Python 3.12.16
pytest 9.2.0
$ echo $?
0
$ echo 3.10.14 > .python-version; pyenv version; python --version
pyenv: version `3.10.14' is not installed (set by /tmp/tmp.HGd1yWj51b/.python-version)
Python 3.12.16
$ pyenv local 3.11; cat .python-version; python --version
3.11
Python 3.11.18

— 2026-11-12 時点の出力

検証環境Python 3.12.16 / Git 2.47.3 / 2026-11-12 検証
検証日
実行環境
python:3.12 Debian GNU/Linux 13 (trixie)
バージョン
  • Python 3.12.16
  • Git 2.47.3

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. 今の選択と、コマンドのある版を調べる

pyenv versions の * が今選ばれている版である。
pyenv whence は、そのコマンドを持つ版を一覧にする(COMMANDS.md(新しいタブで開く))。

pyenv versions
pyenv whence python
* system (set by /root/.pyenv/version)
  3.13.18
3.13.18

2. 版を選ぶ

すべてのディレクトリで使うなら pyenv global、今のディレクトリだけなら pyenv local を打つ。
3.13 のように短く書くと、入っている中で最新の 3.13.18 が選ばれる。

pyenv global 3.13
python --version
Python 3.13.18

system の python3 を残したいときは、system を先頭に並べる。
system に無い python だけが 3.13 から見つかり、python3 は system のままになる。

pyenv global system 3.13
python --version
python3 --version
Python 3.13.18
Python 3.11.2

3. ツールを今の版に入れる

pip で入れたものは、入れた版の中にしか無い。
版を切り替えたら入れ直す。

pyenv whence pytest
pip install pytest

入れ直さずに複数の版から探させるなら、版を並べる。
先に書いた版から順に探され、python は 3.13、pytest も 3.13 のものが動く。
python3.12 は 3.12 が動く。

pyenv global 3.13 3.12

4. .python-version の版を入れる

エラーの前に is not installed の行が出ているなら、書かれている版を入れる。
引数なしの pyenv install は、.python-version に書かれた版を入れる。

cat .python-version
pyenv install

入れない版なら、pyenv local で入っている版に書き換える。
pyenv local は入っていない版を受け付けず、pyenv: version `3.11.9' not installed で止まる。

pyenv local 3.13

よくある原因

  1. pyenv install しただけで版を選んでいない。
    pyenv install は入れるだけで、選択は system のままである。
    Debian 12 のように python3 しか無い環境だと、python3 は動くのに python だけがこのエラーになる。
  2. pip で入れたツールが別の版にある。
    3.13 に pytest を入れたあと 3.12 を選ぶと、pytest の shim は残っているが、3.12 には実体が無い。
  3. .python-version に書かれた版が入っていない。
    pyenv は pyenv: version `3.11.9' is not installed と出したうえで system を探す。
    pyenv global で別の版を選んでいても、そちらは使われなかった。

system に python があると、3 つ目の場合はエラーが出ない。
公式の python イメージでは、.python-version に 3.11.9 と書いても python --version は黙って system の版を返し、pyenv version を打って初めて is not installed が表示された。