rpi.gpio和gpiozero仅适用于树莓派，需确认系统为raspberry pi os；安装需sudo pip3，注意权限与依赖；非树莓派设备不兼容。
Python 的 GPIO 模块通常指 RPi.GPIO（树莓派官方推荐）或更现代的 gpiozero，它们用于在树莓派上控制物理引脚。注意：这些模块仅适用于树莓派等基于 Linux 的 ARM 设备，不能在 Windows 或 macOS 上直接控制硬件 GPIO。
确认系统环境
确保你正在使用树莓派（Raspberry Pi），且已安装 Raspberry Pi OS（原 Raspbian）。运行以下命令检查：
cat /etc/os-release | grep PRETTY_NAME
输出应包含 “Raspberry Pi OS” 或 “Raspbian”。如果不是树莓派，请勿尝试安装 RPi.GPIO —— 它不会起作用，也没有替代硬件支持。
安装 RPi.GPIO（最常用）
该模块预装在大多数 Raspberry Pi OS 版本中。如需手动安装或更新：
发发通b2b电子商务系统
下载
功能介绍：发发通电子商务系统是一套基于php+mysql的免费的b2b电子商务系统。本系统最大的特点在于灵活的安装机制和强大的产品属性定制能力。利用我们的模块装卸功能您可以灵活选择自己需要的功能模块，目前她包括：供求、人才、文章、广告、单网页、友情链接等模块，除此之外她还拥有强大的在线文件管理系统和数据库在线备份还原系统。1、模块化安装：您可以根据自己的需要选择我们提供的模块，这样可以避免您装了自
立即学习“Python免费学习笔记（深入）”；
- 更新系统：
sudo apt update && sudo apt full-upgrade -y - 安装 Python 开发头文件（必要依赖）：
sudo apt install python3-dev - 安装 RPi.GPIO：
sudo pip3 install --upgrade RPi.GPIO
验证是否成功：
在 Python 中运行：
python3 -c "import RPi.GPIO as GPIO; print(GPIO.VERSION)"
若输出版本号（如 '0.7.1'），说明安装成功。
安装 gpiozero（推荐新手）
gpiozero 更简洁易用，是树莓派基金会主推的高级 GPIO 库，已随系统预装。如缺失或需更新：
- 升级：
sudo pip3 install --upgrade gpiozero - 它依赖 RPi.GPIO，会自动处理底层细节
- 测试示例：
python3 -c "from gpiozero import LED; led = LED(17); led.on(); print('LED on')"（需接 LED 到 GPIO17）
常见问题提醒
-
权限问题：运行 GPIO 程序时可能报错 “Permission denied”，请用
sudo python3 xxx.py，或把用户加入gpio组：sudo usermod -aG gpio $USER，然后重启终端 -
别装错包：不要运行
pip install GPIO或pip install python-gpio—— 这些不是官方模块，可能无效甚至冲突 -
非树莓派设备：如用 Orange Pi、Jetson 或普通 PC，需查对应平台的 GPIO 库（如
OPi.GPIO、Jetson.GPIO），不通用
基本上就这些。核心是：只在树莓派上装 RPi.GPIO 或 gpiozero，用 pip3 + sudo，注意权限和依赖。不复杂但容易忽略系统前提。
