在树莓派OS Bookworm中如何安装Python包

原创

已于 2024-04-18 11:19:06 修改 · 3.2k 阅读

32 ·

CC 4.0 BY-SA版权

文章标签：

#python

于 2024-01-11 15:26:54 首次发布

树莓派OS "Bookworm"版本，用于树莓派5上，更改了安装Python模块的方法。

关键要点：

1）树莓派OS Bookworm需要在一个虚拟环境中安装Python包来防止与Python的系统版本发生冲突。

2）你可以使用apt包管理器来搜索和安装Python包，但如果这个包获取不到或者你需要一个更新版本，你需要在一个虚拟环境中使用pip工具。

3）在虚拟环境中任何更改或安装不会影响系统版本Python。

在Raspberry Pi OS Bookworm中使用"pip"工具进行安装Python包吗？你需要采取一些额外步骤，包括创建一个Python虚拟环境。这是如何做这件事。

在树莓派OS Bookworm中做了什么更改

由于树莓派5不兼容更早版本的树莓派OS，你将需要在它上安装新的"Bookworm"。当从一个较早型号切换到树莓派5时，这是需要考虑事情中的一件。

在先前基于Debain的树莓派OS操作系统版本(Buster和更早)中，使用pip包管理工具直接系统范围安装Python库是可能的。但新的树莓派OS Bookworm中不再是这种情况。

如树莓派文档解释，这个问题是使用诸如pip的Python专用工具会产生与apt OS包管理器冲突。因而，从Bookworm之后，在使用pip时，包必须被安装到一个封装的Python虚拟环境中，这个环境确保它们步干扰系统版本的Python。

如果你尝试在系统中任何其它地方使用命令pip install[包名]，你将接收一个以这段文本开始的错误：

user@raspberrypi:/usr/local $ sudo pip install pyepics
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