MediaPipe 人脸检测安装指南一条 pip 命令装好附报错对照表【免费下载链接】mediapipeCross-platform, customizable ML solutions for live and streaming media.项目地址: https://gitcode.com/GitHub_Trending/med/mediapipeMediaPipe 是跨平台实时媒体机器学习框架能跑人脸检测、手势识别、前景分割。最小行动就一条命令pip install mediapipe。当前版本 1.1.0见 mediapipe/version.bzl。先确认走哪条路线你的情况建议路线Python 脚本 / 应用不改源码pip install mediapipe走下文安装主线C / Android / iOS 原生应用按平台文档用 Bazel 构建无需本地编译 Python 包改源码、加 Calculator、提交贡献源码编译 Python 包见源码编译一节PyPI 现成轮子覆盖 x86_64 Linux、x86_64 macOS 10.15、amd64 Windows均为 64 位 Pythonaarch64 LinuxJetson、树莓派无官方轮子只能源码编译见 docs/getting_started/python.md 与 docs/getting_started/troubleshooting.md。装前环境自检检查项标准快速确认方法Python 版本3.9–3.1464 位python3 --version依据 setup.pypip 与 python 同一解释器二者指向一致pip --version里的路径含你的 venvBazel ≥ 3.4.0仅源码编译场景需要bazel --version依据 setup.pyOpenCV3.x–4.1 优先仅源码编译且用--link-opencv场景需要依据 docs/getting_started/install.mdgcc/g 版本避开 6.3 和 7.3仅 TensorFlow Calculator 场景需要依据 docs/getting_started/install.md安装主线三步装好核心包第 1 步隔离安装不污染系统环境。python3 -m venv mp_env source mp_env/bin/activate通过信号提示符前出现(mp_env)。没有该前缀说明没激活后面会装错位置Windows 改用mp_env\Scripts\activate。第 2 步装预编译轮子。pip install mediapipe通过信号结尾出现Successfully installed mediapipe...。看到No matching distribution直接查报错对照表第 1 行。第 3 步确认模块可导入。python3 -c import mediapipe as mp; print(mp.__version__)通过信号打印版本号无 Traceback。源码编译仅定制或贡献需要官方文档原话是有本地改动才需要否则强烈建议 pip installdocs/getting_started/python.md。Debian/Ubuntu 系统依赖照装macOS 把 apt 换成brew install protobufgit clone --depth 1 https://gitcode.com/GitHub_Trending/med/mediapipe mediapipe cd mediapipe sudo apt install python3-dev python3-venv protobuf-compiler python3 -m venv mp_env source mp_env/bin/activate pip install -r requirements.txt python3 setup.py install --link-opencv--link-opencv表示链接系统已装的 OpenCV不带该参数则从源码构建 OpenCV依据 setup.py。⚠️ 构建会临时改写 mediapipe/init.py 与 third_party/BUILD生成.backup文件并在结束自动还原依据 setup.py。若同一目录还要提交补丁先确认已还原或另开一份干净克隆。验收10 行脚本确认装好测试图直接用仓库现成的 mediapipe/objc/testdata/sergey.png拷到脚本同目录并命名sergey.pngcv2随 mediapipe 依赖自动装好import mediapipe as mp import cv2 img cv2.cvtColor(cv2.imread(sergey.png), cv2.COLOR_BGR2RGB) with mp.solutions.face_detection.FaceDetection() as fd: r fd.process(img) print(OK: 检测到, len(r.detections), 张脸) if r.detections else print(NO_FACE)结果对照表运行输出含义下一步动作OK: 检测到 1 张脸安装成功直接进装完之后NO_FACE模块正常图里没检出脸换一张含人脸的图重跑ModuleNotFoundError: No module named mediapipe装进了别的环境核对 pip 与 python 是否同一解释器报错对照表5 条常见报错报错原文、原因与修法均来自 docs/getting_started/troubleshooting.md报错关键词原因处理办法ERROR: Could not find a version that satisfies the requirement mediapipePyPI 无匹配轮子典型为 32 位 Python 或版本越界改用 64 位 Python 3.9–3.14 并用pip --version确认仍不行转源码编译ERROR: An error occurred during the fetch of repository local_execution_config_pythonBazel 找不到本地 PythonBazel 命令追加--action_env PYTHON_BIN_PATH$(which python3)error: undefined reference to cv::String::deallocate()OpenCV 未对 MediaPipe 配好OpenCV 4 按 docs/getting_started/install.md 改 third_party/opencv_linux.BUILD按gcc -print-multiarch输出取消对应头文件行注释ImportError: DLL load failed: The specified module could not be foundWindows 缺 VC 运行时安装vc_redist.x64.exe或用pip install msvc-runtime临时补上ImportError: No module named numpy当前解释器缺 Python 依赖pip install -r requirements.txt装完之后docs/getting_started/python_framework.md想在 Python 里搭自己的计算图的人读它。docs/getting_started/hello_world_cpp.mdC 桌面用户跑bazel run验证环境终端连续打印Hello World!即成功。docs/framework_concepts/calculators.md准备加自定义 Calculator、走源码编译路线的人读它。【免费下载链接】mediapipeCross-platform, customizable ML solutions for live and streaming media.项目地址: https://gitcode.com/GitHub_Trending/med/mediapipe创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
