Raspberry Pi 5需要基于 Debian 12“Bookworm”的新版本 Raspberry Pi 操作系统。如果您正在为 Raspberry Pi 4、Pi 3、Pi Zero 或其他烧录新卡，您可能也会使用 Bookworm。这个新版本的操作系统改变了 Python 模块的安装方式，一开始可能会很混乱。您几乎肯定需要安装 Python 模块来对任何 HAT 进行编程，包括最好的 Raspberry Pi HAT，因此这非常重要。

Python 虚拟环境是一种方便的方法，可让您的 Python 项目包含在内并远离操作系统的默认 Python 安装。过去，我们在操作系统级别安装了 Python 模块，对于我们中的许多人来说，这效果很好，但我们总是面临着破坏操作系统安装的风险。通过 Python 包管理器 pip 安装的 Python 模块总是有可能与使用操作系统包管理器(在本例中为 APT)安装的模块发生冲突。

Raspberry Pi OS 现在基于 Debian 12 “Bookworm”，并且 Debian OS 团队已决定遵循Python 指南 PEP668，因此 Raspberry Pi OS 也必须遵循。如果我们尝试通过 pip 安装模块，我们会收到一条错误消息。

在 Raspberry Pi OS Bookworm 上安装 Python 模块

要在操作系统级别安装 Python 模块，我们需要通过包管理器检查它是否可用，然后才能安装。