Jak vyřešit error: externally-managed-environment při instalaci přes pip3

02.12.2023 Raspberry Pi #raspberrypi #python #error

Řešení pro chybu při instalaci balíčků pythonu na Raspberry Pi.


Při nových instalacích Debian 12 Bookworm se při pokusu o spuštění pip3 install [something] (ať už je to Ansible nebo nějaký jiný nástroj Pythonu) zobrazí se následující chybová zpráva:

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.

Chybová zpráva říká, že můžete předat parametr, --break-system-packages, ale to nevypadá moc bezpečně.

Takže řešením pro Debian 12 (Raspbian) je přinejmenším smazat soubor EXTERNALLY-MANAGED v systémové instalaci Pythonu:

sudo rm -rf /usr/lib/python3.11/EXTERNALLY-MANAGED

Všimněte si, že python3.11 číslo verze by se mělo shodovat s tím, co jste nainstalovali.