第3章树莓派环境搭建

第3章树莓派环境搭建：系统烧录、SSH远程连接、GPIO引脚介绍、Python环境配置

好，咱们正式开始动手了。

这一章，我带你把树莓派从一张「裸板」变成一台能跑能跳的智能家居控制中心。说白了，就是给它装系统、连上你的电脑、认识它的「手脚」（GPIO引脚），最后把Python环境配好。

嗯，这些步骤我几乎每做一个项目都要重复一遍。踩过的坑不少，我会把最实用的经验告诉你。

3.1 系统烧录：给树莓派装上「大脑」

树莓派本身没有硬盘，系统得装在MicroSD卡上。我个人习惯用官方的 Raspberry Pi Imager 工具，省心。

我的建议： 别用第三方烧录工具。官方工具会自动帮你配置好SSH、WiFi，省掉很多后续麻烦。

烧录步骤

下载并安装 Raspberry Pi Imager（官网就有）
插入MicroSD卡到电脑（建议16GB以上，Class 10速度）
打开Imager，选择：
- 树莓派型号：Raspberry Pi 4 / 5（看你手上的板子）
- 操作系统：Raspberry Pi OS (64-bit) —— 我推荐带桌面版，调试方便
- 存储卡：选中你的SD卡
点击右下角齿轮图标（高级设置），提前配置：
- 主机名：raspberrypi.local（方便后面SSH）
- 启用SSH（选密码认证）
- 设置用户名和密码（默认pi/raspberry，建议改掉）
- 配置WiFi（SSID和密码）
点击「写入」，等进度条跑完。

注意： 烧录过程中不要拔出SD卡或断电。我曾经有一次心急拔卡，结果卡直接废了，数据全丢。

烧录完成后，把SD卡插回树莓派，插电开机。第一次启动会有点慢，大概30秒到1分钟。看到绿色指示灯闪烁，说明系统在跑了。

3.2 SSH远程连接：告别显示器和键盘

你想想看，如果每次调试都要接个显示器、键盘、鼠标，那得多麻烦？SSH就是让你用电脑远程操作树莓派的「遥控器」。

Windows用户

我推荐用 PuTTY 或者 Windows Terminal（自带SSH客户端）。

# 打开命令提示符或PowerShell，输入：
ssh pi@raspberrypi.local

# 如果提示「是否继续连接」，输入yes
# 然后输入密码（你烧录时设置的那个）

Mac / Linux用户

直接打开终端，一样操作：

ssh pi@raspberrypi.local

连接不上？别慌，常见原因：

树莓派和电脑必须在同一个WiFi下
检查主机名：如果raspberrypi.local不行，试试IP地址（去路由器后台看）
防火墙可能拦截了SSH端口（22），临时关掉试试

我第一次用SSH时，死活连不上。后来发现是WiFi密码输错了……嗯，这种低级错误谁都犯过。

3.3 GPIO引脚介绍：树莓派的「手脚」

GPIO，全称General Purpose Input Output。说白了，就是树莓派上那一排排金属针脚。你可以把它们想象成树莓派的「手脚」——用来感知外界（输入）和操控设备（输出）。

树莓派40个引脚，功能各不相同。我整理了一张常用引脚表：

引脚编号（物理）	BCM编号（编程用）	功能	备注
1	-	3.3V电源	给传感器供电
2	-	5V电源	给电机等大功率设备
6	-	GND（地）	所有电路必须共地
11	17	GPIO 17	常用数字I/O
12	18	GPIO 18	支持PWM（调光、调速）
13	27	GPIO 27	常用数字I/O
15	22	GPIO 22	常用数字I/O
16	23	GPIO 23	常用数字I/O
18	24	GPIO 24	常用数字I/O
19	10	MOSI（SPI）	SPI通信
21	9	MISO（SPI）	SPI通信
23	11	SCLK（SPI）	SPI通信
24	8	CE0（SPI）	SPI片选
3	2	SDA（I2C）	I2C数据线
5	3	SCL（I2C）	I2C时钟线

编程时用BCM编号，别用物理编号。 比如你想控制物理11号引脚，代码里写的是GPIO 17。我刚开始就搞混过，灯死活不亮，查了半天才发现编号错了。

3.4 Python环境配置：让树莓派听懂你的指令

树莓派官方系统自带Python 3，但有些库需要手动装。咱们要做的，就是装好GPIO控制库和传感器通信库。

第一步：更新系统

sudo apt update
sudo apt upgrade -y

这一步别偷懒。我见过有人跳过更新，结果装库时报各种依赖错误，折腾半天。

第二步：安装GPIO库

# 安装RPi.GPIO（最基础的GPIO控制库）
sudo apt install python3-rpi.gpio

# 安装gpiozero（更高级的封装，适合快速开发）
sudo apt install python3-gpiozero

两个库怎么选？

RPi.GPIO：底层控制，灵活度高，适合需要精确时序的场景
gpiozero：封装好了LED、按钮、传感器等对象，代码更简洁

我个人习惯：快速原型用gpiozero，正式项目用RPi.GPIO。

第三步：安装传感器通信库

# I2C支持（很多传感器用I2C通信）
sudo apt install python3-smbus

# SPI支持
sudo apt install python3-spidev

# 温度传感器DHT11/DHT22
sudo apt install python3-pip
pip3 install Adafruit_DHT

第四步：验证安装

写个简单脚本测试一下：

# test_gpio.py
import RPi.GPIO as GPIO
import time

# 设置引脚模式
GPIO.setmode(GPIO.BCM)
GPIO.setup(17, GPIO.OUT)  # 用BCM 17号引脚

# 让LED闪烁5次
for i in range(5):
    GPIO.output(17, GPIO.HIGH)
    time.sleep(0.5)
    GPIO.output(17, GPIO.LOW)
    time.sleep(0.5)

# 清理
GPIO.cleanup()
print("GPIO测试通过！")

重要提醒： 运行GPIO脚本时，必须用sudo权限！因为GPIO操作需要访问硬件底层。

sudo python3 test_gpio.py

3.5 避坑指南：我踩过的那些坑

供电不足： 树莓派4/5需要5V 3A的电源。用手机充电器（通常只有1A）会导致系统不稳定、WiFi断连。我吃过这个亏，项目演示时突然死机，尴尬到不行。
GPIO烧毁： 千万别把5V直接接到3.3V的GPIO引脚上！树莓派的GPIO是3.3V逻辑电平，接5V会烧掉引脚。加个电平转换模块，几块钱的事。
热插拔： 不要在树莓派通电时插拔GPIO线。虽然不一定每次都坏，但静电和瞬间电流可能损坏引脚。养成断电操作的习惯。
Python版本： 确认你用的是Python 3，不是Python 2。树莓派系统里两个版本都有，用python3命令指定。

好了，环境搭好了，下一章咱们就开始接传感器、写代码，让树莓派真正「感知」这个世界。

公众号:蓝海资料掘金营，微信deep3321

📚 课程目录