pyenv環境でのpipアップデートエラーの原因と解決方法


背景

pyenvを使用した開発環境において、ライブラリを追加した際に、以下のようなpipのアップデートを促すメッセージが表示される場合がある。

[notice] A new release of pip is available: 24.0 -> 24.1.2
[notice] To update, run: python.exe -m pip install --upgrade pip

上記のコマンドをそのまま実行すると、以下のようなエラーメッセージが表示される。

C:\Users\user>python.exe -m pip install --upgrade pip
'python.exe' is not recognized as an internal or external command,
operable program or batch file.

要因

このエラーは、pyenvで開発環境を構築した後に既存のPythonをアンインストールしたことが原因だ。
Pythonをアンインストールする際、環境変数からPythonのパスも削除される。
その結果、システムがpython.exeを認識できなくなり、エラーが発生する。これはシステム上、正しい動作といえる。

解決方法

pyenv環境変数は設定されているため、どのファイルを使ってPythonを起動するかを指定すればよい。
具体的には、pyenv配下のPythonを使用するようにコマンドを修正し、再実行する。

修正後のコマンド例

python -m pip install --upgrade pip

これで問題なくpipのアップデートが実行される。

良いPython LIFEを。