1. 为什么树莓派需要换源？从蜗牛速度到飞一般的体验

我刚拿到树莓派4B的时候，那个兴奋劲儿就别提了，结果第一次执行sudo apt update就傻眼了——下载速度只有几十KB/s，有时候甚至直接卡住不动。后来才知道，树莓派默认的软件源都在国外，国内访问就像是在用拨号上网。

换源其实就是把软件下载地址从国外的服务器切换到国内的镜像站。清华大学开源软件镜像站是我最推荐的选择，速度稳定而且更新及时。我记得第一次成功换源后，更新速度直接从几十KB飙升到10MB/s，那种感觉就像是给树莓派插上了翅膀。

不过换源也不是随便复制粘贴几条命令就行的事情。我刚开始就踩过不少坑，比如架构不匹配导致安装失败，或者密钥错误无法验证软件包。最头疼的一次是换源后系统直接无法更新了，只能重刷系统从头再来。所以今天我就把这些年积累的经验和踩过的坑都分享出来，让你一次搞定树莓派4B的换源操作。

2. 准备工作：确认系统信息，避免架构坑

2.1 查看系统架构

换源前的第一步就是搞清楚你的树莓派到底是什么架构。这点特别重要，因为选错了源会导致所有软件包都无法安装。

打开终端，输入这个命令：

uname -m

你会看到类似这样的输出：

• aarch64：这是64位系统，树莓派4B最推荐的架构
• armv7l：32位系统，兼容性好但性能略有损失
• armv6l：更老的32位系统，现在很少见了

我的树莓派4B显示的是aarch64，所以我需要选择对应的64位源。如果你这里显示的是其他架构，后续的配置也要相应调整。

2.2 确认系统版本

接下来要查看系统版本，因为不同版本的Debian使用不同的源。输入这个命令：

cat /etc/os-release

仔细找找VERSION_CODENAME这一行，你会看到类似bullseye、bookworm这样的代号。这个代号决定了你要用哪个版本的源。

常见版本对应关系：

• bullseye → Debian 11
• bookworm → Debian 12
• buster → Debian 10

记下你的架构和版本代号，这两个信息是后续配置的关键。我建议直接截图保存，免得一会儿还要来回切换窗口查看。

3. 配置清华镜像站：一步步教你搞定

3.1 访问清华镜像站

打开浏览器，访问清华大学开源软件镜像站（mirrors.tuna.tsinghua.edu.cn）。这个站点提供了国内最全的开源软件镜像，速度飞快而且稳定性很好。

在首页找到"Raspberry Pi"分类，点击进入。你会看到两个重要的配置区域：一个是树莓派官方软件源（raspi.list），另一个是系统软件源（sources.list）。别急着复制代码，先看看旁边的问号图标，里面有详细的帮助信息。

我第一次换源的时候就因为没看帮助文档，直接复制了代码，结果版本不对应，搞得一塌糊涂。所以一定要先确认你的系统版本和架构，选择对应的源地址。

3.2 配置树莓派官方源

首先处理树莓派官方软件源，这些是树莓派特有的软件包。打开终端，输入：

sudo nano /etc/apt/sources.list.d/raspi.list

你会看到类似这样的内容：

deb http://archive.raspberrypi.org/debian/ bookworm main

在这行前面加上#注释掉，然后添加清华源的地址。以64位系统为例，添加：

deb https://mirrors.tuna.tsinghua.edu.cn/raspberrypi/ bookworm main

按Ctrl+O保存，回车确认，再按Ctrl+X退出。这里有个小技巧：如果你不确定该用哪个地址，最好回到清华镜像站的页面，仔细查看对应的帮助说明。

3.3 配置系统软件源

接下来配置更重要的系统软件源。在终端输入：

sudo nano /etc/apt/sources.list

你会看到一堆以deb http://开头的行。同样地，在这些行前面加上#注释掉。

现在回到清华镜像站页面，找到"Raspbian"部分（虽然现在叫Raspberry Pi OS，但源名称还是raspbian）。点击问号图标，根据你的架构选择对应的源。

对于树莓派4B的64位系统，我推荐使用Debian的源而不是Raspbian的源，因为兼容性更好。复制灰色框中的内容，粘贴到刚才打开的配置文件中。

完整的配置应该类似这样：

deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware

再次按Ctrl+O保存，Ctrl+X退出。这时候你已经完成了大部分的配置工作，但还差最后关键一步。

4. 常见问题与解决方案：避开我踩过的那些坑

4.1 密钥验证失败问题

执行sudo apt update时，你可能会遇到这样的错误：

The following signatures couldn't be verified because the public key is not available

这是因为缺少相应的GPG密钥。解决方法很简单，先记下缺失的密钥ID（那一长串数字字母组合），然后执行：

sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com [你的密钥ID]

比如我之前遇到的是82B129927FA3303E，就执行：

sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 82B129927FA3303E

这个问题在新系统中比较常见，特别是bookworm版本。执行完这个命令后再更新，应该就能顺利通过了。

4.2 404错误与架构不匹配

有时候更新时会看到404错误，提示找不到软件包。这通常是因为架构不匹配导致的。比如你的系统是64位，却配置了32位的源。

解决方法是回到第二步，重新确认你的系统架构和版本。特别是要注意，树莓派4B有32位和64位两种系统，一定要区分清楚。

另一个常见错误是混淆了Ubuntu和Debian的源。树莓派官方系统是基于Debian的，所以应该使用Debian的源，而不是Ubuntu的源。虽然两者很像，但软件包并不完全兼容。

4.3 速度反而变慢了？

偶尔会有朋友问我，为什么换了国内源速度反而变慢了。这通常是因为网络运营商的问题。有些地区的网络访问清华镜像站可能不如访问其他镜像站快。

如果你遇到这种情况，可以尝试其他镜像站，比如阿里云镜像站或中科大镜像站。配置方法类似，只是替换一下网址而已。

不过在我多年的使用经验中，清华镜像站对大多数用户来说都是最快最稳定的选择。如果你确实遇到速度问题，可以先ping一下镜像站地址，看看网络延迟如何。

5. 验证与优化：确保换源成功

5.1 测试更新速度

完成配置后，首先执行更新：

sudo apt update

你应该能看到下载速度明显提升。我这边通常能跑到8-10MB/s，相比之前的几十KB简直是天壤之别。

如果速度没有提升，可能是配置有误。检查一下/etc/apt/sources.list和/etc/apt/sources.list.d/raspi.list这两个文件，确保没有拼写错误，并且注释掉了原来的源。

5.2 全面升级系统

更新源列表成功后，执行全面升级：

sudo apt upgrade

这会更新所有已安装的软件包。第一次换源后升级的软件包可能会比较多，需要一些时间。升级过程中可能会询问是否确认，输入Y继续就行。

升级完成后，我建议重启一下系统：

sudo reboot

这样能确保所有更新都正确加载。重启后再次执行apt update和apt upgrade，确认没有需要更新的软件包。

5.3 定期维护建议

换源不是一劳永逸的事情。我建议每个月至少执行一次全面更新，保持系统处于最新状态。同时注意关注清华镜像站的公告，偶尔会有地址变更或维护通知。

如果你将来升级了系统版本（比如从bullseye升级到bookworm），记得要重新配置软件源，因为版本代号变了，源的地址也要相应调整。

还有个实用小技巧：你可以把原来的源配置备份一下，这样万一新源出问题，可以快速恢复。我就是这样做的，虽然几乎从来没用到过备份，但有备无患嘛。

树莓派4B的硬件性能相当不错，配上快速的软件源，体验真的很流畅。我记得换源成功后，安装软件再也不用漫长等待，编译项目时依赖下载也快了很多。这种提升是实实在在能感受到的，特别是当你需要频繁安装调试的时候。