安装 GPIO Zero

GPIO Zero 默认安装在 Raspberry Pi OS 桌面镜像、 Raspberry Pi OS Lite 镜像 和 Raspberry Pi OS Desktop PC/Mac 镜像中。请按照以下指南在其他操作系统上进行安装，包括使用 remote GPIO 功能的 PC。

树莓派

GPIO Zero 已打包在 Raspberry Pi OS、Debian 和 Ubuntu 的 apt 仓库中。它也可在 PyPI 上使用。

apt

首先，更新软件源列表：

sudo apt update

然后安装 Python 3 的软件包：

sudo apt install python3-gpiozero

或 Python 2 的软件包：

sudo apt install python-gpiozero

pip

如果你在 Raspberry Pi 上使用的是其他操作系统，你可能需要安装 GPIO Zero。使用get-pip 安装 pip，然后键入：

sudo pip3 install gpiozero

或者对于 Python 2

sudo pip install gpiozero

要在虚拟环境中安装 GPIO Zero，请参阅 开发 页面。

PC/Mac

要在 PC 或 Mac 上使用 GPIO Zero 的远程 GPIO 功能，您需要使用 pip 在电脑上安装 GPIO Zero。更多信息，请参阅 remote_gpio 页面。 页面获取更多信息。

文档

该文档也可用于离线安装，例如

sudo apt install python-gpiozero-doc

这将把 HTML 版本的文档安装到 /usr/share/doc/python-gpiozero-doc/html 路径下。要查看离线文档有几种选择：

您可以直接通过浏览器打开文档访问 file:///usr/share/doc/python-gpiozero-doc/html/index.html。 不过，请注意使用 file:// URL 有时会破坏某些元素。 为了避免这种情况，您可以通过 http:// 样式的 URL 来查看文档，方法是用 Python 启动一个轻量 HTTP 服务器。 用 Python 启动一个轻量 HTTP 服务器来查看文档：

python3 -m http.server -d /usr/share/doc/python-gpiozero-doc/html

然后在浏览器中访问 http://localhost:8000/。

另外，该软件包还集成了 Debian 的 doc-base 系统，所以您可以安装 doc-base 客户端（dochelp、dwww、dhelp、doc-central 等），并使用其界面查找此文档。

如果你想在不同的设备上离线查看文档，如电子阅读器等设备上离线查看文档，可从 ReadTheer 网站下载电子书和 PDF 版本的文档。 可从 ReadTheDocs 网站下载。只需点击页面左下角的 阅读文档 框，然后选择 PDF 或 EPUB。

---

中文翻译版以英文版相同知识授权方式共享：BSD-3-Clause。交流 Q群：498908352