Python venv作成時に「Pythonが見つかりません」エラーが発生する

冒頭

Pythonの仮想環境を作成するためにpython -m venv envやpython3 -m venv myenvコマンドを実行したところ、「Errno 2: No such file or directory」や「Python interpreter cannot be found」というエラーが発生して、仮想環境の作成に失敗してしまう問題があります。

特にAnacondaやHomebrewを使用してPythonをインストールした場合、または複数バージョンのPythonを共存させている場合に起こりやすいエラーです。

結論

Pythonのパスを明示的に指定するか、環境変数PYTHON_PATHを設定することで、この問題を解決できます。

具体的な手順

ステップ1：現在のPythonパスを確認する

まず、現在コマンドラインで使用しているPythonがどこにあるか確認します。

# Windowsの場合
where python

# macOS/Linuxの場合
which python3
which python

また、Pythonのバージョンも確認しておきましょう。

python3 --version
python --version

ステップ2：システムにインストールされているPythonを一覧表示する

複数のPythonがインストールされている場合、どれが正しいか確認します。

# Windowsの場合（Pythonがインストールされている可能性を確認）
dir /s C:python*.exe

# macOSの場合
/usr/bin/python3
/usr/local/bin/python3
ls -la /Library/Frameworks/Python.framework/Versions/

# Linuxの場合
ls /usr/bin/python*
ls /usr/local/bin/python*

ステップ3：正しいPythonのパスを指定してvenvを作成

見つかったPythonのパスを直接指定して仮想環境を作成します。

# 例：Python3.11を使用する場合（パスは環境に合わせて変更）
python3.11 -m venv myenv

# Windowsの場合の例
C:Python311python.exe -m venv myenv

# 絶対パスで指定
/usr/local/bin/python3 -m venv myenv

ステップ4：仮想環境が正常に作成されたことを確認

# 仮想環境をアクティブにする
# Windowsの場合
myenvScriptsactivate

# macOS/Linuxの場合
source myenv/bin/activate

# アクティブになったことを確認
which python
python --version

ステップ5：それでも解決しない場合の対応

Python自体がシステムにない場合、Pythonをインストールする必要があります。

# HomebrewでPythonをインストール（macOS）
brew install python

# Anacondaを使用している場合
conda create -n myenv python=3.11
conda activate myenv

補足・注意点

Anacondaユーザーの場合：conda createコマンドの使用を検討してください。Anaconda環境では標準のvenvではなく、conda環境を使用することが推奨されています。
Homebrewユーザーの場合：HomebrewでインストールしたPythonがデフォルトになる場合があるため、brew doctorで警告がないことを確認してください。
バージョン指定の重要性：python3.11のようにバージョンまで指定することで、特定のバージョンのPythonを使用できます。
シンボリックリンクの問題：Pythonのシンボリンクが破損している場合があります。その場合はPythonを再インストールしてください。
権限問題：システムディレクトリに書き込めない場合は、ユーザーに書き込み権限があるか確認するか、ユーザーディレクトリ内で仮想環境を作成してください。

【Python venv】Pythonを見つけられないエラーの解決法