できない.dev

pyenv「no such command `virtualenv'」の原因と直し方

pyenv の no such command virtualenv は、プラグインの pyenv-virtualenv を入れれば直る。
pyenv 本体にこのコマンドは無い。
入れる先は $(pyenv root)/plugins である。

公開: 更新:

症状できない · exit 1
pyenv virtualenv system myenv
pyenv: no such command `virtualenv'
解決後できた · exit 0
pyenv virtualenv system myenv
Looking in links: /tmp/tmp8mz5aszv
Requirement already satisfied: pip in /root/.pyenv/versions/myenv/lib/python3.12/site-packages (25.0.1)

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

要約

pyenv virtualenv を打つと、pyenv 2.8.14 では次のエラーで止まる。
終了コードは 1 になる。

pyenv: no such command `virtualenv'

pyenv 本体に virtualenv というコマンドは無い。
プラグインの pyenv-virtualenv を入れれば直る。
同じプラグインが提供する pyenv virtualenvs と pyenv activate も、入れる前は同じ形のエラーになる。

実行例

pyenv 2.8.15 を clone しただけの状態で pyenv virtualenv system myenv を打つと、no such command で終了コード 1 になった。
pyenv-virtualenv を plugins に clone すると、同じコマンドで環境が作られ、pyenv activate myenv も通った。

$ pyenv --version
pyenv 2.8.15
$ pyenv virtualenv system myenv
pyenv: no such command `virtualenv'
$ echo $?
1
$ pyenv commands | grep virtualenv
$ ls $(pyenv root)/plugins
pyenv-binary
pyenv-link
python-build
$ git clone -q https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv
$ pyenv virtualenv --version
pyenv-virtualenv 1.4.1 (python3 -m venv)
$ echo $?
0
$ pyenv virtualenv system myenv
Looking in links: /tmp/tmp8mz5aszv
Requirement already satisfied: pip in /root/.pyenv/versions/myenv/lib/python3.12/site-packages (25.0.1)
$ echo $?
0
$ pyenv virtualenvs
  myenv (created from /usr/local)
$ pyenv activate myenv
Python 3.12.16
myenv

— 2026-11-13 時点の出力

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

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

解決策

1. プラグインを入れる

git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv
pyenv virtualenv --version

手元では pyenv-virtualenv 1.4.1 (python3 -m venv) と表示された。
macOS の Homebrew で入れた pyenv には、brew install pyenv-virtualenv が案内されている(公式の README(新しいタブで開く))。

2. pyenv root を確かめて入れ直す

pyenv root
ls $(pyenv root)/plugins

一覧に pyenv-virtualenv が無ければ、別の場所へ clone している。
上の手順で入れ直す。

3. シェルを起動し直す

exec "$SHELL"
pyenv activate myenv

新しいシェルでは pyenv activate が通った。
ディレクトリに入ったときの自動切り替えも使うなら、README に従ってシェルの設定へ次の行を足す。

eval "$(pyenv virtualenv-init -)"

4. 仮想環境を作る

pyenv virtualenv system myenv
pyenv virtualenvs

system の位置には、pyenv install で入れた版も渡せる。
入っていない版を渡すと pyenv-virtualenv: `9.9.9' is not installed in pyenv. で止まる。
作った環境は pyenv local myenv でディレクトリに割り当てられる。

プロジェクトごとの仮想環境だけが目的なら、プラグインは要らない。
python -m venv .venv でも作れる。

よくある原因

  1. プラグインを入れていない。
    clone した直後の pyenv の plugins には、pyenv-binary、pyenv-link、python-build しか無い。
    pyenv commands の一覧にも virtualenv は出てこない。
  2. clone した場所が違う。
    pyenv が探すのは pyenv root の下の plugins である。
    PYENV_ROOT を ~/.local/share/pyenv に変えた環境で ~/.pyenv/plugins へ clone すると、エラーは消えない。
  3. プラグインを入れる前に起動したシェルを使い続けている。
    pyenv virtualenv は通るようになるが、pyenv activate は別のエラーで止まる。
    eval "$(pyenv virtualenv-init -)" を同じシェルで打っても消えなかった。
`pyenv activate' requires Pyenv and Pyenv-Virtualenv to be loaded into your shell.