最近のUbuntu
やRaspberryPi
を使用しているとpipコマンド
でライブラリのインストールをするときにPEP668
のエラーが出てきます。
以下は最新のRaspberryPi OS
であるDebian GNU/Linux 12 (bookworm)
でpipコマンド
を使用してnumpy
を
インストールしてみた結果になります。
$ pip install numpy error: externally-managed-environment × This environment is externally managed ╰─> To install Python packages system-wide, try apt install python3-xyz, where xyz is the package you are trying to install. If you wish to install a non-Debian-packaged Python package, create a virtual environment using python3 -m venv path/to/venv. Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make sure you have python3-full installed. For more information visit http://rptl.io/venv note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages. hint: See PEP 668 for the detailed specification.
エラーメッセージはaptコマンド
を使用したインストールとpipコマンド
でインストールがバッティングするのでvenv
を使用してねというメッセージになります。最近のPython
のライブラリ関係はライブラリとしての使用はもちろんなのですが、エントリーポイントのような形で単体で動くコマンドのような役割を持ったものも多く存在しています。そのため、pipコマンド
でのインストールでは仮想環境であるvenv
を使用したほうが環境の混濁にならないのでいいですよ~という警告になります。もちろん、このあたりの回避方法はオプションスイッチの指定であったり、設定ファイルなどを使用すれば回避可能です。
【参考】
ですが、その他の方法として、pipx
という方法もあるようです。先程のpipコマンド
を実行時には表示されていませんでしたが、以前は以下の表示がありました。pipx
を使用するのが簡単ですよってことのようです。
If you wish to install a non-Debian packaged Python application, it may be easiest to use pipx install xyz, which will manage a virtual environment for you. Make sure you have pipx installed.
【参考】
自分はpipx
の存在については初耳でもあったので、ちょっと調べてみました。