M2 Pro Mac安装mediapipe后VS Code提示ModuleNotFoundError求助

1. 先确认mediapipe的实际安装环境 #

打开终端执行以下命令：

• 查看pip3对应的Python路径：which pip3
• 检查该环境是否真的装了mediapipe：pip3 list | grep mediapipe
• 记下当前Python版本：python3 --version

2. 匹配VS Code的Python解释器 #

在VS Code里按Cmd+Shift+P打开命令面板，输入Python: Select Interpreter，选择和刚才终端里which pip3输出路径一致的Python版本。

3. 处理虚拟环境或路径冲突 #

• 如果用了虚拟环境，先在项目目录终端激活环境（比如source venv/bin/activate），再重新装一遍：pip install mediapipe
• 直接在VS Code的内置终端里执行安装命令，确保用的是当前选中解释器的pip，避免全局环境和项目环境不匹配。

4. M2芯片专属适配 #

ARM架构的M2可能存在兼容性问题，试试强制重装：

pip install mediapipe --force-reinstall --no-cache-dir

如果是通过homebrew装的Python，确保VS Code选的是/opt/homebrew/bin/python3这个路径的解释器，对应homebrew的原生ARM版本环境。

5. 验证修复结果 #

在VS Code的终端里运行这段代码：

import mediapipe as md
print(md.__version__)

能正常输出版本号就说明问题解决了。

内容的提问来源于stack exchange，提问作者SHOULD_3R