树莓派 3B / Zero 2 W / Zero W 刷机教程:选对 32 位或 64 位系统写卡
树莓派 3B、3B+、Zero 2 W、Zero W 等老型号和小板子装 Raspberry Pi OS:按型号选 arm64 或 armhf 文件,用 Raspberry Pi Imager 写 microSD 卡,无头设置 SSH 与 Wi-Fi 的注意事项,附指示灯排错。约 15 分钟。
适用于树莓派官方系统 Raspberry Pi OS
先确认型号:选 64 位还是 32 位
这几款老型号和小板子装系统的步骤一样,都是写 microSD 卡,区别只在选哪个文件:
| 型号 | 处理器 | 选哪种文件 | 网络 |
|---|---|---|---|
| Raspberry Pi Zero 2 W | 64 位四核 | arm64(64 位) | 只有 2.4 GHz Wi-Fi,没有网口 |
| Raspberry Pi 3B | 64 位四核 | arm64(64 位) | 2.4 GHz Wi-Fi + 网口 |
| Raspberry Pi 3B+ | 64 位四核 | arm64(64 位) | 2.4/5 GHz Wi-Fi + 网口 |
| Raspberry Pi 3A+ | 64 位四核 | arm64(64 位) | 2.4/5 GHz Wi-Fi,没有网口 |
| Raspberry Pi Zero W / WH | 32 位单核 | 只能用 armhf(32 位) | 只有 2.4 GHz Wi-Fi,没有网口 |
| Raspberry Pi Zero / Zero H | 32 位单核 | 只能用 armhf(32 位) | 没有无线也没有网口 |
| Raspberry Pi 1、2 | 32 位 | 用 armhf(32 位) | 1B、1B+、2B 有网口,没有无线 |
Zero 2 W 和 Zero W 外形尺寸相同,容易拿错。分不清时可以先用 32 位精简版开机,运行下面的命令:
cat /proc/device-tree/compatible | tr '\0' '\n'应看到:第一行是 raspberrypi,model-zero-2-w(Zero 2 W)、raspberrypi,model-zero-w(Zero W)、raspberrypi,3-model-b-plus(3B+)或 raspberrypi,3-model-b(3B)等。
树莓派 4B、400、5 和计算模块请看各自的教程:树莓派 4B 刷机教程、树莓派 5 刷机教程。
准备
- 电源:树莓派官方推荐 5V 2.5A 的 micro USB 电源。Zero 系列有两个 micro USB 口,电源要插标着 PWR IN 的那个。
- microSD 卡:精简版 8 GB 以上,桌面版 32 GB 以上。Zero、初代树莓派和早期树莓派 2 只能从不超过 256 GB 的启动分区启动,建议直接用 256 GB 以下的卡。
- 一台电脑和读卡器;本站的 Raspberry Pi Imager。
- Zero 系列接显示器要用 mini-HDMI 转 HDMI 线,接键盘要用 micro USB OTG 转接头;同时接键盘和鼠标要加带电源的 USB 集线器。
下载哪个文件
打开 Raspberry Pi OS 下载页,文件名格式是 日期-raspios-版本-架构(-类型).img.xz:
| 文件名 | 用途 |
|---|---|
…-raspios-trixie-arm64-lite.img.xz / …-armhf-lite.img.xz | 精简版,没有桌面。官方说明精简版适合初代树莓派、树莓派 2 和 Zero 这类老型号 |
…-raspios-trixie-arm64.img.xz / …-armhf.img.xz | 桌面版 |
…-raspios-trixie-arm64-full.img.xz / …-armhf-full.img.xz | 完整版,多装 LibreOffice 等软件,占空间大 |
…-raspios-bookworm-… | Legacy 旧版(Debian 12),只在你的软件明确要求旧版时选 |
arm64 和 armhf 按上面的型号表选。下载后核对页面上的 SHA-256,方法见 如何核对下载文件的 SHA-256。
本站暂未收录这些型号的 OpenWrt 文件,本页只介绍 Raspberry Pi OS。
写入 microSD 卡
Imager 有中文界面,下面括号里是英文界面的名称。
- 把 microSD 卡插进电脑,打开 Raspberry Pi Imager。
- 在“设备(Device)”页选你的型号(例如 Raspberry Pi Zero 2 W),点“下一步(Next)”。
- 在“操作系统(OS)”页拉到最下面,选“使用自定义镜像(Use custom)”,选中下载好的
.img.xz,不用解压。 - 在“储存设备(Storage)”页选你的 microSD 卡。保持勾选“排除系统驱动器(Exclude system drives)”,按容量认准是哪张卡。
- 点“写入(Write)”,再点“我理解,擦除并写入(I understand, erase and write)”。写完后 Imager 会自动校验,等它显示完成,点“结束(Finish)”。
- 把卡插进卡槽(树莓派 3 和 Zero 的卡是直接推进去,不会“咔哒”一声),接上电源。
注意用“使用自定义镜像”写入本站下载的文件时,当前版本的 Imager(2.0)不会出现“自定义设置(Customisation)”页,不能提前设置用户名、Wi-Fi 和 SSH。Zero W 和 Zero 2 W 没有网口,不接显示器使用时必须提前设置 Wi-Fi:请在 Imager 的系统列表里直接选 Raspberry Pi OS(由 Imager 从树莓派官网下载),在“自定义设置(Customisation)”里填好用户和 Wi-Fi,并在“远程访问(Remote access)”里打开“开启 SSH(Enable SSH)”。也可以给它接 USB 网卡改用网线,再按下面的 ssh + userconf.txt 方法设置。
警告写入会清空整张卡。
提示树莓派 3B+ 和 Zero 2 W 也能直接从 U 盘启动,写法相同,存储设备选 U 盘即可。树莓派 3B、3A+ 要先永久改写芯片里的一次性设置才能从 USB 启动,本页不建议这样做。
第一次开机:怎么登录
树莓派从 2022 年 4 月起取消了默认的 pi / raspberry 账号,现在没有通用的默认密码:
- 桌面版:接显示器和键盘,第一次开机会进入设置向导,依次设置国家和语言、创建用户名和密码、连接 Wi-Fi、选默认浏览器、更新软件。
- 精简版:没有向导,接显示器后在命令行按提示创建用户名和密码。
- 用网线、不接显示器(3B、3B+、1、2):写完卡后,在电脑上打开卡里的
bootfs分区,新建一个名为ssh的空文件,再新建userconf.txt,里面只写一行用户名:加密后的密码。加密后的密码在电脑终端运行openssl passwd -6生成(macOS 自带的 LibreSSL 不支持-6,要另装 OpenSSL)。 - 只有 Wi-Fi 的 Zero W / Zero 2 W:从 Bookworm 版起,往卡里放
wpa_supplicant.conf配置 Wi-Fi 的老办法已经不能用了,请按上面“注意”里的方法用 Imager 提前设置,或者接显示器和键盘走设置向导。这两款只支持 2.4 GHz Wi-Fi,连不上 5 GHz 网络。 - 找到树莓派:默认主机名是
raspberrypi,在电脑上运行ssh 用户名@raspberrypi.local;或者登录路由器后台查看它的 IP。更多方法见 开发板第一次登录。
以后升级
在终端运行 sudo apt update && sudo apt full-upgrade,不用重新写卡。
刷坏了怎么救
- 这些型号没有板载启动程序,启动文件都在 microSD 卡里,重新写一张卡就能恢复。
- 看绿色指示灯判断原因:短闪 4 次表示找不到启动文件,短闪 7 次表示找不到内核,短闪 8 次表示内存故障。多半是卡没写好、选错了 32/64 位文件,或者卡本身坏了,换卡重写一次。
- Zero 系列开机后再插 USB 设备,电压下降可能导致重启。先接好 USB 设备再上电,或用带电源的集线器。
- 想看启动日志:串口在 40 针排针上,GPIO14(8 号针,TX)和 GPIO15(10 号针,RX),波特率 115200;Raspberry Pi OS 里要先在
raspi-config的 Interface Options → Serial Port 打开。见 用 USB 转 TTL 串口调试开发板。
资料来源
按树莓派官方文档(Zero 系列与各型号规格、联网能力表、电源要求、启动介质、安装系统、设置向导、无头设置、USB 启动、指示灯代码、串口)、树莓派官方博客 2022 年 4 月关于取消默认用户的说明,以及 Raspberry Pi Imager 2.0 源码整理(2026-10-22 查阅)。本站 Raspberry Pi OS 为 2026-10-06 版。
提示本页按厂商官方文档整理,本站没有在实机上测试。接口位置以你的板子和树莓派官方说明为准。
适用的固件与系统镜像(1)
按适用范围匹配到 1 个固件条目。下载前仍需核对具体型号和硬件版本。
整理:AppGoBox · 依据 · 本站未在实机上逐一验证