树莓派4B（Raspbian 11）安装MediaPipe后导入失败如何解决？
2026-8-20
解决Raspberry Pi 4B上MediaPipe导入失败的问题
可能的原因及对应解决办法
1. 64位系统兼容性问题
mediapipe-rpi4这个包主要是为32位Raspbian编译的，如果你用的是64位Bullseye，大概率会出现兼容性问题，导致安装后Python找不到模块。
- 两种解决方向：
- 切换回32位Raspbian系统（适合不需要64位特性的场景）
- 直接安装官方适配ARM64架构的MediaPipe：执行
sudo pip3 install mediapipe（去掉-rpi4后缀，官方现在已经支持树莓派4的64位系统）
2. pip与Python版本不匹配
树莓派上可能同时存在多个Python版本，pip3安装的包可能对应到了另一个Python版本，而你运行脚本用的版本没装这个包。
- 排查和解决：
- 先查当前用的Python版本：
python3 --version - 再查pip3对应的Python版本：
pip3 --version - 如果版本不一致，用对应版本的pip来安装，比如你的Python是3.9，就执行
python3.9 -m pip install mediapipe-rpi4
- 先查当前用的Python版本：
3. 全局/用户安装路径冲突
用sudo pip3是全局安装，但如果你用普通用户权限运行脚本，可能访问不到全局包；或者之前用用户权限装过其他版本，导致路径混乱。
- 解决办法：
- 试试不用
sudo，以用户权限安装：pip3 install --user mediapipe-rpi4，然后用普通用户运行脚本 - 查看Python的包安装路径：
python3 -c "import site; print(site.getsitepackages())"，确认mediapipe文件夹是否在这些路径里
- 试试不用
4. 安装不完整或缓存问题
有时候终端显示安装成功，但实际文件有缺失，可能是pip缓存搞的鬼。
- 解决步骤：
- 先卸载已装的包：
sudo pip3 uninstall -y mediapipe-rpi4 - 清理pip缓存：
pip3 cache purge - 重新安装（64位系统就装官方版
mediapipe）
- 先卸载已装的包：
内容的提问来源于stack exchange，提问作者test 1
相关产品推荐
相关产品推荐
