## 事象
以下のように[[Pip]]でインストールをしようとしたら
```console
pip install xxx
```
以下のエラーが出る。
```error
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.
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.
See /usr/share/doc/python3.11/README.venv for more information.
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.
```
## 原因
[[Marking Python base environments as “externally managed”|PEP 668]]によるもの。
## 解決方法
仮想環境を作成してその中でインストールする。
CI環境など、明らかに破壊の心配がない場合は `--break-system-packages` オプションを指定して回避もできる。
## 参考
- ["This environment is externally managed"のエラーが出たとき、python仮想環境をつかう。|真壁匠](https://note.com/lucky_gerbil210/n/n0de8721c05bc)