树莓派5开发环境配置与VSCode远程调试实战-CSDN博客

1. 树莓派5系统初始化与环境准备

树莓派5到手后第一件事就是系统初始化，这个环节看似简单但实际踩坑不少。我刚开始玩树莓派的时候，就因为SD卡烧录问题折腾了好几个小时。现在官方推荐的Raspberry Pi Imager工具确实方便，支持一键下载系统镜像并烧录到SD卡，还能预先配置Wi-Fi、SSH和地区设置。

烧录系统时有个细节要注意：一定要用Class 10以上的高速SD卡，不然系统运行会卡顿。我之前用老旧的Class 4卡，光是启动系统就花了三分钟，更别说跑代码了。烧录完成后把SD卡插入树莓派5，接上电源和网线，等待指示灯稳定闪烁就说明系统启动成功了。

没有显示器的话，可以通过SSH远程连接。首先需要获取树莓派的IP地址，可以在路由器后台查看，或者用Advanced IP Scanner这类工具扫描局域网。找到IP后，用SSH客户端连接，默认用户名是pi，密码是raspberry。第一次登录会要求修改密码，这个步骤千万别跳过，毕竟安全第一。

系统基础配置还包括时区设置和语言包安装。建议直接运行sudo raspi-config进行可视化配置，这里面可以设置时区、键盘布局、分辨率等常用选项。我习惯先把时区调到Asia/Shanghai，避免后面日志时间对不上。

提示：如果烧录过程中SD卡出现问题，可以在Windows下用diskpart工具清理。打开管理员权限的CMD，输入diskpart → list disk → select disk X（X是你的SD卡编号）→ attributes disk clear readonly → clean。这样就能重新烧录了。

2. 开发环境依赖安装与优化

系统搞定后就要搭建开发环境了。树莓派5的ARM架构和x86平台有些差异，直接安装某些库可能会遇到兼容性问题。我的经验是先用apt update和apt upgrade更新系统，确保所有包都是最新版本。

基础开发工具链是必须的：

sudo apt install -y build-essential cmake pkg-config git

这些工具是编译C/C++程序的基础，后续安装OpenCV等库都会用到。

Python环境是重点。树莓派5预装了Python 3.9，但建议用虚拟环境管理项目依赖。由于PEP 668规范的限制，现在系统Python环境不能直接pip安装包，必须用venv：

sudo apt install python3-venv
python3 -m venv ~/pyenv
source ~/pyenv/bin/activate

激活虚拟环境后，提示符前面会出现(pyenv)标识，这时候用pip安装的包都会放在这个隔离环境里。

换源是必须操作，能大幅提升下载速度。清华源和中科大源都不错，我习惯用中科大的源：

sudo sed -i 's|raspbian.raspberrypi.org|mirrors.ustc.edu.cn/raspbian|g' /etc/apt/sources.list
sudo sed -i 's|archive.raspberrypi.org|mirrors.ustc.edu.cn/raspberrypi|g' /etc/apt/sources.d/raspberrypi.list

pip源也要换，创建~/.pip/pip.conf文件：

[global]
index-url = https://pypi.mirrors.ustc.edu.cn/simple
trusted-host = pypi.mirrors.ustc.edu.cn
<