树莓派拿到手的第一件事永远是把系统装进去。这件事听起来简单——下载镜像、写卡、插电、开机——但真正动手过的人都知道从选哪个系统版本、用哪个烧录工具到第一次开机连不上网、SSH 死活登不进去每一步都藏着让人抓狂的小坑。我前后经手过十几块树莓派从早期的 3B 到现在的 5每次装系统都会遇到点新情况也慢慢总结出一套相对稳妥的流程。这篇内容就把整个系统安装过程拆开讲透从镜像选型、烧录工具对比、无屏幕配置到首次启动后的基础设置和常见故障排查尽量让第一次接触树莓派的人也能一次点亮少走弯路。1. 装系统之前先想清楚你到底要拿树莓派干什么很多人拿到板子就急着找镜像下载结果装完发现版本不对、桌面跑不动、或者根本用不上图形界面。系统选型这一步其实比烧录本身更重要选错了后面全是返工。1.1 官方 Raspberry Pi OS 和 Ubuntu 到底怎么选树莓派官方系统 Raspberry Pi OS 是基于 Debian 定制的对硬件兼容性最好GPIO 库、摄像头模块、官方配件基本都是开箱即用。如果你要做的是控制舵机、读取传感器、驱动 OV5647 这类摄像头模块或者跟着大多数树莓派教程走官方系统是最省心的选择。它现在主要分三个版本带桌面和推荐软件的完整版、带桌面的标准版、以及 Lite 无桌面版。Ubuntu 这边树莓派官方支持的是 Ubuntu Server 和 Ubuntu Desktop 两个方向版本上 22.04 LTS 和 24.04 LTS 是主流。选 Ubuntu 的典型场景是你要跑 ROS2、要部署自己训练的 YOLOv5 模型、或者团队统一用 Ubuntu 生态做开发。Ubuntu 在树莓派 5 上的支持已经相当成熟但要注意树莓派 4B 装 Ubuntu Desktop 会比较吃力内存 4GB 以下的建议直接上 Server 版。我个人的判断标准很简单跟硬件打交道多、要跑图形界面小工具、追求稳定省心选 Raspberry Pi OS要做 AI 推理、机器人开发、服务器类应用选 Ubuntu Server。两者都能装 Python都能 SSH差别主要在软件源和预装环境上。1.2 桌面版还是 Lite 版一个被低估的选择新手容易有个误区觉得有桌面才完整。实际上树莓派作为嵌入式设备绝大多数项目根本不需要图形界面。Lite 版没有桌面环境内存占用能省下几百 MB启动更快跑后台服务更稳。你完全可以在 Lite 版上通过 SSH 完成所有操作需要图形界面时用 VNC 远程连一下就行。什么时候必须上桌面版一是你要用树莓派当轻量办公机或者媒体中心二是你要跑一些只有图形界面的软件三是你刚开始学、需要可视化操作来降低门槛。除此之外Lite 版是更专业的选择。我手上长期跑的几块板子全是 Lite 版稳定运行几个月不用重启。1.3 32 位和 64 位的取舍树莓派 4B 和 5 都支持 64 位系统官方也早就提供了 64 位镜像。64 位系统能用到更大的内存寻址空间跑 AI 模型、编译大型项目时优势明显。但 32 位系统在某些老旧的闭源驱动和特定库上兼容性更好。判断方法如果你的树莓派是 4B2GB 及以上或者 5直接上 64 位没有悬念。如果是 3B 或者 3B内存只有 1GB32 位系统反而更轻快。树莓派 Zero 系列基本只能跑 32 位。这个选择在下载镜像时就要定下来装完再换等于重来一遍。2. 镜像下载与烧录工具别在第一步就踩坑镜像下载和烧录是纯体力活但工具选不对、操作不规范后面开机就是各种玄学问题。这一节把下载渠道、工具对比和烧录细节讲清楚。2.1 镜像从哪下、怎么校验官方镜像统一在 raspberrypi.com 的 software 页面下载Ubuntu 镜像在 ubuntu.com 的下载页找 Raspberry Pi 版本。下载时优先选 torrent 或者官方直链第三方镜像站虽然快但存在被篡改的风险装系统这种事不值得省那几分钟。下载完一定要校验。官方会提供 SHA256 校验值Windows 上用 certutil 命令Linux 和 macOS 上用 sha256sum 命令比对一下哈希值。这一步很多人跳过但如果镜像在下载过程中损坏烧录出来的卡开机就是各种报错排查起来非常痛苦。校验通过再往下走能省掉一大半莫名其妙的故障。2.2 Raspberry Pi Imager 和 balenaEtcher 的实测对比烧录工具主流就两个官方出的 Raspberry Pi Imager 和第三方的 balenaEtcher。我两个都用过很多次说下实际感受。Raspberry Pi Imager 最大的优势是内置了高级设置。在烧录前按 CtrlShiftX 可以调出配置面板直接预设主机名、开启 SSH、配置 WiFi、设置用户名密码和地区。这意味着你烧录完插卡就能直接 SSH 连上完全不需要显示器和键盘。这个功能对无屏幕安装来说是决定性的也是我现在首选它的原因。balenaEtcher 的优势是界面简洁、跨平台一致性好、烧录速度快但它没有预设配置功能烧录完还得手动改配置文件才能无屏幕启动。如果你手边有显示器键盘用 Etcher 也没问题如果要做无屏幕部署Imager 明显更合适。对比项Raspberry Pi ImagerbalenaEtcher预设 SSH/WiFi支持烧录前配置不支持需手动改文件烧录速度中等较快界面友好度一般简洁直观镜像来源官方库自定义自定义适用场景无屏幕部署首选有屏幕时快速烧录2.3 烧录时的几个硬性注意点第一TF 卡选 Class 10 以上、A1 或 A2 等级的容量 16GB 起步32GB 是比较舒服的甜点。劣质卡是树莓派故障的头号来源系统跑着跑着卡死、文件系统损坏八成是卡的问题。第二烧录前确认卡里没有重要数据烧录会全盘覆盖。烧录完成后系统会提示你拔出再插入这一步别省让系统重新识别分区。第三Windows 上烧录完可能会弹出需要格式化的提示千万不要点格式化那是 Windows 不认识 Linux 分区导致的点了就把刚烧好的系统毁了。直接关掉弹窗拔卡即可。3. 无屏幕无键盘安装SSH 和 WiFi 的预配置树莓派最实用的玩法就是无屏幕安装烧录完直接 SSH 连上去操作。这一节把预配置的完整流程讲透包括 Imager 图形化配置和手动改配置文件两种方式。3.1 用 Imager 高级设置一步到位打开 Raspberry Pi Imager选好系统和存储卡后按 CtrlShiftX 进入高级选项。这里要填的东西有几个关键项设置主机名比如 raspberrypi.local后面 SSH 就用这个地址连启用 SSH选使用密码认证设置用户名和密码配置无线局域网填 WiFi 名称、密码、国家代码中国填 CN设置区域选项时区选 Asia/Shanghai键盘布局选 us填完保存正常烧录。烧录完成后插卡上电等一两分钟在同一局域网内的电脑上就能用ssh 用户名主机名.local连上。这个流程我实测过几十次成功率很高前提是 WiFi 名称和密码别填错国家代码别漏。3.2 手动配置boot 分区放两个文件如果你用的是 balenaEtcher 或者想更精细地控制可以手动配置。烧录完成后电脑上会出现一个名为 boot 的小分区Windows 下能直接看到macOS 和 Linux 也能挂载。在这个分区的根目录放两个文件第一个是空的ssh文件没有扩展名内容为空。它的存在就是告诉系统开机启动 SSH 服务。Windows 上新建文本文档后要把 .txt 后缀删掉注意别变成 ssh.txt。第二个是wpa_supplicant.conf文件内容如下countryCN ctrl_interfaceDIR/var/run/wpa_supplicant GROUPnetdev update_config1 network{ ssid你的WiFi名称 psk你的WiFi密码 key_mgmtWPA-PSK }注意 ssid 和 psk 要用英文引号WiFi 名称区分大小写。如果 WiFi 是隐藏的还要加一行scan_ssid1。这个文件在首次启动后会被系统移动到 /etc/wpa_supplicant/ 目录boot 分区里就看不到了这是正常现象。3.3 首次 SSH 连接的常见卡点连不上的情况我遇到过很多次基本集中在几个原因。一是主机名解析失败.local这种 mDNS 解析在部分 Windows 系统上需要装 Bonjour 服务最稳妥的办法是登录路由器后台查树莓派的 IP直接用 IP 连。二是 WiFi 没连上可能是国家代码没填、密码有特殊字符、或者路由器开了 MAC 地址过滤。三是 SSH 服务没起来检查 ssh 文件是不是真的没有扩展名。排查顺序建议先 ping 主机名不通就 ping IPIP 也不通说明网络没连上去路由器看设备列表。IP 能通但 SSH 拒绝说明 SSH 服务没启动重新检查 ssh 文件。这个排查链路能覆盖九成以上的连接问题。4. 首次开机后的基础配置换源、更新、远程桌面系统连上之后还有一批基础配置要做。这些配置决定了后续用起来顺不顺手尤其是换源这一步不换的话 apt 安装软件能慢到让人怀疑人生。4.1 换源国内用户的必修课树莓派官方系统默认的软件源在国外国内直接 apt update 经常超时或者龟速。换源就是把源地址改成国内镜像站。以 Debian 系的 Raspberry Pi OSbookworm 或 trixie 版本为例需要改两个文件/etc/apt/sources.list和/etc/apt/sources.list.d/raspi.list。操作前先备份sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak sudo cp /etc/apt/sources.list.d/raspi.list /etc/apt/sources.list.d/raspi.list.bak然后把文件里的raspbian.raspberrypi.org和archive.raspberrypi.org替换成国内镜像站的地址。不同版本代号不一样bookworm 对应 bookwormtrixie 对应 trixie改之前先用lsb_release -a确认系统版本代号别改错了。Ubuntu 系统换源改的是/etc/apt/sources.list把ports.ubuntu.com替换成国内镜像地址。Ubuntu 22.04 代号 jammy24.04 代号 noble同样要对上。换完源执行sudo apt update sudo apt upgrade -y更新过程可能要几分钟到十几分钟取决于更新量。这一步做完系统基础环境就绪了。4.2 时区、语言和键盘布局时区不对会导致日志时间错乱、定时任务执行时间偏移。设置命令sudo raspi-config在 Localisation Options 里依次设置时区Asia/Shanghai、键盘布局Generic 105-key布局选 Other→English (US)、WiFi 国家代码CN。Ubuntu 系统用sudo dpkg-reconfigure tzdata设置时区。中文输入法这块如果跑的是 Lite 版基本用不上桌面版需要的话装 fcitx 加拼音输入法但树莓派上跑输入法会占资源非必要不装。4.3 开启 VNC 远程桌面Lite 版没有桌面但如果你偶尔需要图形界面可以装一个轻量桌面再开 VNC。更常见的做法是桌面版系统直接开 VNC 服务。在 raspi-config 的 Interface Options 里启用 VNC然后在电脑上用 VNC Viewer 连接树莓派IP:5900。VNC 连接需要先设置 VNC 密码第一次连接会提示。实测下来树莓派 4B 以上跑 VNC 体验还可以3B 会比较卡。如果只是偶尔看看图形界面VNC 够用如果要长期跑图形应用建议直接接显示器。4.4 系统备份别等卡坏了才后悔树莓派用 TF 卡做存储卡是有寿命的尤其是频繁读写日志的场景。系统配好之后建议做一次完整备份。方法是在电脑上用 dd 命令或者 Win32 Disk Imager 把整张卡读成镜像文件存起来。这样下次卡坏了直接烧录备份镜像几分钟就能恢复到配好的状态不用从头再来一遍。备份镜像会比较大等于卡的容量但这一步的价值在出问题的时候体现得淋漓尽致。我吃过没备份的亏一块跑了半年的卡突然挂掉所有配置和项目代码全没了只能重装重配花了大半天。5. 装完系统后跑不起来的排查思路系统装完不代表万事大吉开机黑屏、卡在彩虹屏、SSH 连不上、apt 报错这些都是高频问题。这一节按故障现象分类给出排查链路。5.1 开机无显示或卡在彩虹屏彩虹屏是树莓派 GPU 初始化的画面正常情况下一闪而过。如果一直卡在这里常见原因有几个。一是 TF 卡烧录不完整或者卡本身有问题换张卡重烧试试。二是电源供电不足树莓派 4B 和 5 对电流要求高用手机充电头经常带不动建议用官方电源或者 5V 3A 以上的适配器。三是镜像和板子型号不匹配比如把树莓派 5 的镜像烧给了 4B。排查顺序先换电源再换卡最后确认镜像版本。这三个换下来基本能定位问题。5.2 SSH 连接被拒绝或超时前面提过一部分这里补充几个细节。如果之前连上过、突然连不上可能是 IP 变了DHCP 租约到期去路由器重新查 IP。如果一直连不上检查 ssh 文件是否生效可以在 boot 分区确认文件还在不在首次启动后 ssh 文件会被删除这是正常的说明服务已启动。还有一种情况是系统启动到一半卡住了SSH 服务没起来。这时候接个显示器看看启动日志或者用串口调试。树莓派 4B 和 5 支持串口登录需要 USB 转 TTL 模块接线是 GND 对 GND、TX 对 RX、RX 对 TX。串口能看到完整的启动过程是排查启动问题的利器。5.3 apt 更新报错和依赖问题换源之后 apt update 报错常见的是 GPG 密钥错误或者源地址写错。GPG 错误一般是镜像站的密钥没导入按提示执行导入命令即可。源地址写错的话检查版本代号是否和系统匹配bookworm 的源不能用在 bullseye 系统上。依赖冲突多出现在手动装了一些第三方 deb 包之后。这时候用sudo apt --fix-broken install尝试修复还不行就sudo apt autoremove清理无用依赖再重试。实在搞不定回滚到换源前的备份文件重新来一遍。5.4 忘记密码怎么办树莓派忘记密码是高频问题尤其是放了很久没用的板子。解决办法是把卡拔下来插到电脑上在 boot 分区FAT32 格式Windows 能直接读写新建一个userconf.txt文件内容格式是用户名:加密后的密码。加密密码可以用在线工具生成或者在有 Linux 环境的机器上用openssl passwd -6 你的密码生成。放好文件后插卡启动系统会自动读取这个文件并设置密码然后删除该文件。启动后用新密码登录即可。这个方法对 Raspberry Pi OS 有效Ubuntu 系统的处理方式不同需要进恢复模式改密码相对麻烦一些。6. 几个让装系统更顺手的实操心得装系统这件事流程是固定的但细节上的经验能省很多时间。最后分享几个我踩坑之后总结出来的点。第一TF 卡买好一点的。三星 EVO、闪迪 Extreme 这类 A2 等级的卡价格贵不了多少但稳定性和速度差距明显。劣质卡用几个月就开始出问题数据无价别在这上面省。第二烧录工具固定用一个。我长期用 Raspberry Pi Imager因为它的预设配置功能太省事了。工具换来换去容易在配置环节出岔子固定一个用熟就好。第三第一次装系统接个显示器。虽然无屏幕安装很酷但第一次接触树莓派的话接个 HDMI 显示器能看到启动过程出问题也好判断。等熟悉了再玩无屏幕部署。第四系统配好立刻备份。前面强调过了这里再提一次因为真的太重要了。备份镜像存好下次出问题直接恢复比重新配置快十倍。第五记录你的配置。主机名、用户名、密码、WiFi 信息、换源地址这些记在一个文档里。树莓派放久了很容易忘有记录就不用重新折腾。装系统是树莓派所有项目的地基地基打稳了后面跑 Python、接传感器、部署模型才顺。这套流程我用了很多次从 3B 到 5 都验证过按这个走基本不会出大问题。真遇到卡住的地方按故障现象对照排查大部分都能自己解决。