连接树莓派4B摄像头常因教程过时而失败。本指南梳理了从系统烧录到摄像头测试的全过程，并针对新版OS的配置变更和常见错误提供了明确的解决方案，帮助用户绕开弯路，快速完成项目搭建。
智能速览
新系统配置路径变更，trixie与bookworm版需修改/boot/firmware/config.txt
libcamera和raspistill等旧指令已失效，新版系统需使用rpicam系列指令
摄像头配置需手动添加dtoverlay参数，并禁用camera-auto-detect
可通过SSH和VNC实现无屏幕远程登录与桌面操作
UPS扩展板与散热器存在安装冲突，散热器优先级更高
精华内容
网上多数树莓派摄像头教程已严重过时，导致新手频频踩坑。下面将梳理适配新版OS的正确配置流程与核心避坑点。
硬件准备与连接
基础硬件包括树莓派4B、32G以上的miniSD卡及一个读卡器用于烧录系统。强烈建议加装散热器，可将24小时开机的温度稳定在35度以下。
连接摄像头排线时，需轻轻上提CSI接口的黑色固定片，插入排线后再按紧，确保蓝色一端朝向USB端口方向。值得注意的是，UPS电源扩展板与散热器存在物理冲突，无法同时安装，应根据需求取舍，通常散热更为关键。
远程登录设置
无屏幕环境下，需先通过Raspberry Pi Imager烧录系统，并在烧录时预设SSH、用户名、密码及Wi-Fi信息。将SD卡插入树莓派并通电后，在同一局域网下通过电脑终端使用ssh命令登录。
若需图形化桌面操作，则需通过SSH执行sudo raspi-config命令，进入Interface Options启用VNC服务。随后在电脑上安装RealVNC Viewer，输入树莓派的IP地址即可远程连接其桌面环境。
摄像头核心配置
这是最关键且最易出错的一步。首先必须通过sudo lsb_release -a命令确认系统版本，因为不同版本的配置路径和方法差异巨大。
对于bullseye系统，配置文件为/boot/config.txt；而对于trixie和bookworm新系统，路径已迁移至/boot/firmware/config.txt。使用sudo nano命令打开对应文件后，需将camera-auto-detect=1改为0，并添加一行dtoverlay=ov5647（摄像头型号需根据实际购买型号修改），保存后重启生效。
指令测试与使用
重启后，通过ssh或VNC打开终端，输入ls /dev命令，若列表中出现video0，则表示摄像头已被系统识别。
后续测试应使用新版系统专用的rpicam系列指令。例如，使用rpicam-hello --qt-preview进行预览，rpicam-jpeg -o test.jpg --qt-preview拍摄照片，rpicam-vid -t 10000 -o test.h264 --qt-preview录制10秒视频。早期教程中的raspistill、libcamera-vid等指令已在新系统中被弃用。
遵循本指南，即可高效完成树莓派4B与摄像头的连接，为后续的图像处理、AI识别等项目打下坚实基础。你准备好用树莓派开启你的计算机视觉之旅了吗？
