树莓派轻量Python环境核心是禁用编译、用系统预编译包、关冗余:ARM编译弱易OOM,apt装python3-opencv等秒装且依赖自动解决;须同步修改apt主源、raspi.list和pip.conf三处清华源;用venv而非pipenv;装包加--only-binary=all强制跳过编译。

树莓派上配轻量 Python 环境,核心不是“装最新版”,而是「关掉冗余、跳过编译、用系统预编译包」——否则 pip install 会卡在 Building wheel,风扇狂转,KeyboardInterrupt 都没反应。
为什么默认 pip 安装在树莓派上容易假死
ARM 架构编译能力弱,很多 PyPI 包没有提供 manylinux_aarch64 轮子,pip 默认走源码编译;而树莓派默认 CONF_SWAPSIZE=100,编译 OpenCV 或 PyTorch 这类库时直接 OOM。现象是终端无响应、Ctrl+C 失效、swapon --show 显示 swap 已满。
- 别信“加大 swap 就能一劳永逸”:2GB swap 开太久,SD 卡写入寿命断崖式下降
- 别盲目升级系统自带的
python3:Raspberry Pi OS 的python3(当前为 3.11/3.12)已足够用,升级反而可能破坏 apt 包依赖 - 别用
pip install装大库:优先走sudo apt install python3-opencv、python3-torch,它们是官方预编译的 ARM64 二进制包,秒装且依赖自动解决
换源必须改三个地方,漏一个就失败
只改 /etc/apt/sources.list 不够,raspi.list 和 pip.conf 同样关键。清华源地址要和系统版本严格匹配(比如 Bookworm 对应 https://mirrors.tuna.tsinghua.edu.cn/raspbian/raspbian/bookworm/)。
-
sudo nano /etc/apt/sources.list:替换为清华镜像(注意路径含bookworm或bullseye) -
sudo nano /etc/apt/sources.list.d/raspi.list:这个控制python3-opencv等硬件相关包,漏改会导致apt install报 404 -
mkdir -p ~/.pip && nano ~/.pip/pip.conf:写入index-url = https://pypi.tuna.tsinghua.edu.cn/simple/和trusted-host = pypi.tuna.tsinghua.edu.cn
用 venv 隔离环境,但别用 pipenv 或 poetry
树莓派资源紧张,pipenv 和 poetry 启动慢、内存占用高,还会偷偷调用 pip 升级自身——在低内存设备上极易触发 OOM。用系统自带的 venv 最稳妥。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
立即学习“Python免费学习笔记(深入)”;
- 创建:
python3 -m venv ~/myenv - 激活:
source ~/myenv/bin/activate - 装包前先确认:
which pip应该指向~/myenv/bin/pip,而不是系统全局的/usr/bin/pip3 - 装包时加
--only-binary=all强制跳过编译:pip install --only-binary=all numpy(部分包如shiboken2仍需手动下载 wheel)
PySide2 / PyQt5 这类 GUI 库,直接 apt 装最省心
PySide2 在树莓派上不推荐 pip 安装,shiboken2 编译极慢且易失败。系统源里已打包好全部模块,按需安装即可。
- 全量装(桌面版适用):
sudo apt install python3-pyside2.qtcore python3-pyside2.qtwidgets python3-pyside2uic - 验证:
python3 -c "from PySide2.QtWidgets import QApplication; print('OK')" - 打包用
pyinstaller时若报缺shiboken2,去 Qt 官方 wheel 页面 下载对应 aarch64 的shiboken2-*.whl,然后pip install xxx.whl
真正轻量的关键,是克制“我要最新版”的冲动——系统自带的 python3、apt 提供的预编译包、禁用 swap 后的纯二进制安装,三者叠加才能让树莓派不卡、不烫、不崩。那些需要编译的包,要么放弃,要么提前交叉编译好再拷过去。

















