树莓派：ModuleNotFoundError: No module named 'mediapipe'

### 树莓派上安装 MediaPipe 的解决方案 MediaPipe 是 Google 提供的一个跨平台框架，用于构建多媒体处理管道。然而，在树莓派这样的 ARM 架构设备上安装 Python 库可能会遇到兼容性和依赖项问题。 #### 1. **确认错误原因** 当出现 `ModuleNotFoundError` 错误时，通常是因为目标库未正确安装或环境配置不匹配。对于树莓派上的 MediaPipe 安装失败情况，可能的原因包括： - 缺少必要的编译工具链。 - 不支持的硬件架构（某些预编译二进制文件仅适用于 x86 或 AMD64 平台）。 - OpenCV 和其他依赖项版本冲突[^1]。 #### 2. **解决方法** ##### (a) 更新系统并安装必要依赖 在尝试安装任何第三方包之前，请先更新操作系统及其软件源列表，并安装开发所需的工具集： ```bash sudo apt update && sudo apt upgrade -y sudo apt install -y build-essential cmake git pkg-config libopencv-dev python3-opencv \ python3-pip python3-setuptools python3-wheel ``` 这一步确保了基础环境已准备好接收后续操作所需资源[^2]。 ##### (b) 创建虚拟环境隔离现有设置 为了避免污染全局解释器状态或者与其他项目发生干扰，建议创建一个新的Python虚拟工作区来管理特定需求下的依赖关系： ```bash python3 -m venv mediapipe-env source ./mediapipe-env/bin/activate pip install --upgrade pip setuptools wheel ``` 激活后的提示符前缀应显示 `(mediapipe-env)` 表明当前处于该专属空间之中[^3]。 ##### (c) 手动编译适合ARM处理器的MediaPipe组件 由于官方发布的whl文件主要面向主流桌面级CPU设计，因此针对Raspberry Pi这类嵌入式单板计算机则需自行定制化组装流程如下所示： 1. 下载最新版源码压缩包至本地目录； ```bash wget https://github.com/google/mediapipe/archive/master.zip unzip master.zip cd mediapipe-master/ ``` 2. 修改Bazel构建选项适应Linux+Arm组合条件；编辑`.bazelrc`文档加入以下参数行： ``` build:raspberry_pi --copt=-mfpu=neon-vfpv4 --cpu=cortex-a72 --host_cpu=k8 --fat_apk_cpu=arm64-v8a,armeabi-v7a --crosstool_top=@bazel_tools//tools/cpp:toolchain --action_env=BAZEL_CXXOPTS="-fPIC" ``` 3. 使用Docker镜像辅助完成复杂交叉链接过程(可选)，具体参照官方指南说明执行相应命令序列即可[^4]。 ##### (d) 验证最终成果 如果一切顺利的话，则可以通过简单的测试脚本来验证功能是否正常运作: ```python import cv2 import mediapipe as mp mp_hands = mp.solutions.hands.Hands(static_image_mode=False,max_num_hands=2,min_detection_confidence=0.5) cap=cv2.VideoCapture(0) while True: ret,img=cap.read() results=mp_hands.process(cv2.cvtColor(img,cv2.COLOR_BGR2RGB)) if not ret : break annotated_img=img.copy() if results.multi_hand_landmarks is None : continue for handLms in results.multi_hand_landmarks : mp_drawing.draw_landmarks( image=annotated_img, landmark_list=handLms, connections=mp.solutions.holistic.HAND_CONNECTIONS ) cv2.imshow('Hand Tracking',cv2.flip(annotated_img,flipCode=1)) keypress=cv2.waitKey(1)&0xFF if(keypress==ord('q'))or(not(ret)): cap.release();break; cv2.destroyAllWindows(); ``` 以上代码片段展示了如何利用摄像头捕捉实时画面并通过MediaPipe检测双手位置标记点绘制连线图样效果展示出来[^5]。 ---