树莓派轻量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+ 需要开启：辅助功能 + 屏幕录制权限
- 创建：
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 后的纯二进制安装，三者叠加才能让树莓派不卡、不烫、不崩。那些需要编译的包，要么放弃，要么提前交叉编译好再拷过去。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
