Mac M2环境下VS Code与Python配置异常：import cv2报错求助

算力阿峰

2026-7-14

解决VS Code中Python模块找不到的问题

针对你遇到的终端能正常运行Python脚本，但VS Code里提示ModuleNotFoundError的问题，试试下面几个实用方案：

确认VS Code终端的Python解释器路径
打开VS Code内置终端，输入命令查看当前使用的Python路径：
```
which python3
```
把这个路径和系统终端里which python3的输出、以及settings.json里配置的路径对比。如果不一致，大概率是VS Code没加载你的shell配置文件（比如.zshrc或.bashrc），重启VS Code即可解决，或者手动在终端执行source ~/.zshrc（对应你的shell类型）。
直接在VS Code终端重新安装依赖
不管之前在系统终端装过没，直接在VS Code的终端里用对应pip安装模块，比如安装cv2：
```
pip3 install opencv-python
```
这样安装的模块会直接关联到VS Code当前使用的Python解释器，从根源避免路径不匹配问题。
检查虚拟环境状态
如果你的项目用了虚拟环境，先确认VS Code左下角显示的解释器是不是对应虚拟环境里的Python，或者看VS Code终端有没有虚拟环境的前缀（比如(venv)）。如果没激活，手动激活虚拟环境后再安装依赖：
```
# 假设虚拟环境在项目根目录的venv文件夹
source venv/bin/activate
pip install opencv-python
```
重新确认Python解释器配置
按Cmd+Shift+P（Mac）或Ctrl+Shift+P（Windows/Linux），输入Python: Select Interpreter，重新选择你通过Homebrew安装的Python 3路径，这个操作会自动更新settings.json配置，确保实际生效。