树莓派Bookworm起默认不提供pip命令，仅预装pip3，且系统级pip安装被PEP 668禁止；需用apt安装或创建虚拟环境后使用pip，否则报“externally-managed-environment”错误。
树莓派上不能直接用 pip，必须用 pip3；从 Bookworm 开始，系统级安装被禁止，必须进虚拟环境或改用 apt。
为什么 pip 命令找不到
树莓派默认不提供 pip 命令别名，只预装 pip3。执行 pip install xxx 会报 Command 'pip' not found，这不是环境变量问题，而是根本没这个可执行文件。
- 检查是否已装
pip3：运行pip3 --version，若提示未找到，则需先装python3-pip - 安装命令是
sudo apt install python3-pip，不是get-pip.py或手动编译（除非你用的是极简版系统） - 不要尝试
sudo ln -s /usr/bin/pip3 /usr/bin/pip—— 这在 Bookworm+ 系统里可能触发externally-managed-environment错误
Bookworm 及之后版本禁止系统级 pip 安装
从 Raspberry Pi OS Bookworm（基于 Debian 12）起，Python 的系统 site-packages 被标记为 “externally managed”，任何直接 pip3 install 都会失败，并提示：
error: externally-managed-environment × This environment is externally managed ╰─> To install Python packages system-wide, try apt install python3-xyz...
这是 PEP 668 的强制行为，不是树莓派自定义限制。
Ai Podcast Pipeline
下载
从QuickView趋势笔记生成韩语AI播客包，含双人主持脚本（Callie×Nick）、Gemini多说话人TTS音频、字幕时间轴与渲染修正、缩略图+MP4包装及YouTube标题/描述输出。支持完整版（15~20分钟）和压缩版（5~7分钟）。
- 正确做法一：用
apt安装已有打包的库，例如sudo apt install python3-opencv、sudo apt install python3-paho-mqtt - 正确做法二：创建虚拟环境再用
pip：python3 -m venv ~/myenv→source ~/myenv/bin/activate→pip install opencv-python - 错误做法：加
sudo强行绕过、删/usr/lib/python3.10/EXTERNALLY-MANAGED文件 —— 后续系统升级可能出问题
如何安全地换 pip 源加速安装
树莓派 ARM 架构下从官方 PyPI 下载 wheel 包极慢，且容易超时失败。国内源必须配在用户级配置，避免影响系统级 apt 行为。
- 创建用户级配置：
mkdir -p ~/.pip，然后编辑~/.pip/pip.conf - 写入内容（以清华源为例）：
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cn
- 切记不要改
/etc/pip.conf—— Bookworm 默认不读该路径，且可能被系统包管理覆盖 - 验证是否生效：运行
pip3 config list，应看到global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'
pip3 安装失败的常见卡点
即使命令对、源也换了，仍可能卡在编译或权限环节，尤其涉及 OpenCV、YOLOv5 这类带 C 扩展的包。
-
ModuleNotFoundError: No module named 'distutils.util'：缺构建工具，运行sudo apt install python3-distutils python3-setuptools -
ERROR: Could not build wheels for numpy：ARM 上编译太耗资源，优先用pip3 install --only-binary=all numpy或改用apt install python3-numpy -
PermissionError: /usr/local/lib/python3.10/site-packages：说明你没进虚拟环境又没加sudo，但加sudo会破坏虚拟环境隔离 —— 正确解法是回到venv里重装 - YOLOv5 报
torch安装失败：树莓派 4B/5 不支持官方 PyTorch ARM wheel，得用piwheels源或降级到 torch 1.12（仅限 Python 3.9）
真正麻烦的从来不是“怎么装”，而是“装完能不能跑”。Bookworm 的 externally-managed-environment 机制和 ARM 编译限制，会让很多直接抄桌面端教程的操作当场失效。动手前先确认 OS 版本、Python 版本、目标库是否提供 ARM wheel，比反复重试 pip 命令更省时间。
