2024.10.1 树莓派4B Bookworm系统OpenCV安装避坑指南：从清华源配置到公钥修复

1. 树莓派系统准备与基础配置

在开始安装OpenCV之前，我们需要确保树莓派系统已经正确安装并进行了基础优化。树莓派4B的性能虽然不错，但默认配置下可能无法充分发挥硬件潜力，特别是对于OpenCV这种需要大量计算资源的库来说更是如此。

首先需要下载最新的Raspberry Pi OS（64位）系统镜像。推荐使用官方的Raspberry Pi Imager工具进行烧录，这个工具非常直观易用，只需要选择操作系统、存储卡，然后点击写入即可。烧录完成后别急着拔出SD卡，我们还需要进行一些重要设置。

在烧录工具中有一个高级设置选项（齿轮图标），这里可以预先配置Wi-Fi连接、开启SSH服务、设置主机名和用户密码。强烈建议在这里就配置好Wi-Fi信息，这样树莓派启动后就能自动连接到网络，省去后续很多麻烦。特别是如果你准备使用手机热点，记得确保电脑和树莓派都连接到同一个热点，这样才能在同一个局域网内互相访问。

系统首次启动后，建议先进行系统更新和文件系统扩展。通过SSH连接到树莓派（可以使用Putty或者直接使用终端），执行sudo raspi-config命令，选择Advanced Options中的Expand Filesystem来扩展文件系统，这样才能充分利用SD卡的全部空间。完成后重启系统，让更改生效。

接下来我们需要安装一些基础工具包，这些将在后续的OpenCV安装过程中用到：

sudo apt update
sudo apt upgrade -y
sudo apt install -y git cmake build-essential
sudo apt install -y libjpeg-dev libtiff5-dev libjasper-dev libpng-dev
sudo apt install -y libavcodec-dev libavformat-dev libswscale-dev libv4l-dev
sudo apt install -y libgtk2.0-dev libatlas-base-dev gfortran

这些依赖包包含了图像处理、视频编解码、图形界面等基础功能库，OpenCV在编译和运行过程中都会用到它们。安装过程中可能会遇到依赖关系问题，通常按照提示操作即可解决。如果某个包无法安装，可以尝试先更新软件源列表再重新安装。

2. 清华源配置详细指南

在国内使用树莓派官方源安装软件时，下载速度往往很慢，特别是像OpenCV这样的大型软件包。使用清华大学的镜像源可以显著提高下载速度，节省大量时间。但配置过程中需要注意一些细节，否则可能会导致软件源失效甚至系统问题。

首先备份原有的源列表文件，这样如果配置出现问题可以快速恢复：

sudo cp /etc/apt/sources.list /etc/apt/sources.list.backup
sudo cp /etc/apt/sources.list.d/raspi.list /etc/apt/sources.list.d/raspi.list.backup

接下来编辑主源列表文件，使用nano编辑器打开文件：

sudo nano /etc/apt/sources.list

将文件内容全部注释或删除，替换为以下清华源配置。注意这里使用的是bookworm系统对应的源，如果你使用的是其他版本的系统，需要相应调整：

deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports 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

保存并退