树莓派 GPIO Python 编程全攻略：从引脚认知到实战项目

GPIO（通用输入输出）引脚是所有树莓派单板计算机的核心扩展接口，通过它可连接传感器、执行器、显示屏等外设，赋予树莓派感知与控制物理世界的能力。本教程将系统讲解 GPIO 引脚定义、硬件接线、Python 编程环境搭建及经典实战项目，助您快速上手物理计算开发。

GPIO 基础认知

图 1：40 引脚 GPIO 排布

GPIO 即 General Purpose Input/Output，是树莓派 SoC 直接引出的可编程数字信号引脚，支持 3.3V 电平。通过软件配置，每个引脚可动态切换为输入（读取按键、传感器）或输出（驱动 LED、继电器、电机驱动模块）模式。树莓派 Zero / 3B+/4B/5 均采用标准 40Pin 排针（早期 Model A/B 为 26Pin），引脚功能定义完全兼容。

40Pin 功能详解（BCM 编号模式）

图 2：树莓派 4B 主板

注意：GPIO 电平为 3.3V，严禁直接接入 5V 信号，否则烧毁 SoC。驱动大电流负载请使用晶体管、MOSFET 或光耦隔离模块。

Python 编程环境搭建

图 3：Python 编程概念

硬件准备清单

• 树莓派开发板（已烧录 Raspberry Pi OS）
• MicroSD 卡（≥16GB Class 10）
• 面包板、公母杜邦线、330Ω 电阻、LED、按键、PIR 人体红外传感器
• （可选）Pi Wedge T 型扩展板或 GPIO 转接板，便于面包板接线

软件库选择：GPIO Zero vs RPi.GPIO

本教程以 GPIO Zero 为主，兼顾 RPi.GPIO 关键设置。

RPi.GPIO 基础初始化代码

import RPi.GPIO as GPIO
GPIO.setmode(GPIO.BCM)        # 采用 BCM 编号
GPIO.setwarnings(False)       # 关闭重复配置警告
GPIO.setup(17, GPIO.OUT)      # 设置 GPIO17 为输出
GPIO.output(17, GPIO.HIGH)    # 输出高电平点亮 LED

GPIO Zero 典型用法示例

from gpiozero import LED, Button, MotionSensor
from signal import pause

led = LED(17)                 # GPIO17 接 LED
btn = Button(2)               # GPIO2 接按键（内部上拉）
pir = MotionSensor(4)         # GPIO4 接 PIR 传感器

btn.when_pressed = led.on
btn.when_released = led.off
pir.when_motion = led.on
pir.when_no_motion = led.off

pause()                       # 保持主线程运行，响应事件

进阶实战项目推荐

图 4：树莓派 4B

常见坑点避雷指南

• 引脚编号混淆：代码中统一使用 BCM 模式，并在原理图标注物理引脚号；
• 缺少上下拉电阻：输入模式建议启用内部上拉 GPIO.PUD_UP 或外接 10kΩ 电阻；
• 电流超限：单个 GPIO 最大 16mA，总和 ≤50mA，大功率负载必须外接驱动电路；
• 未清理资源：程序退出前调用 GPIO.cleanup() 或 GPIO Zero 的 device.close()；
• 权限问题：非 root 运行需将用户加入 gpio 组：sudo usermod -a -G gpio $USER 后重登。

结语

掌握 GPIO 编程是树莓派从“会跑 Linux 的小电脑”进化为“物理计算核心”的关键一步。建议从 GPIO Zero 入手，逐步深入底层寄存器与中断机制，结合传感器融合、边缘计算、容器化部署等现代技术栈，构建属于您的智能硬件生态。如有疑问，欢迎随时交流探讨。