Python导入cv2提示无法解析 安装时报非零退出码2如何解决？

1 优先确认安装环境匹配 #

90%以上的该类报错都是编辑器使用的Python解释器，和你安装opencv包的环境不匹配导致的：

• 执行以下命令验证安装情况：
  查看当前生效Python路径：which python3（Mac/Linux）或where python（Windows）
  验证opencv是否安装完成：pip3 list | grep opencv（Mac/Linux）/pip3 list | findstr opencv（Windows）
• 如果没有返回opencv相关包，先执行残留卸载+重新安装命令：

  pip3 uninstall opencv-python opencv-contrib-python opencv-python-headless -y
  pip3 install opencv-python -i https://pypi.tuna.tsinghua.edu.cn/simple
  

  使用国内镜像源可解决官方源网络超时导致的Non-zero exit code (2)报错。

2 编辑器解释器配置修正 #

VSCode配置 #

• 按下Ctrl+Shift+P（Mac端为Cmd+Shift+P），搜索并选择Python: Select Interpreter
• 在弹出列表中选中你刚才执行pip安装命令对应的Python解释器即可

PyCharm配置 #

• 依次打开File → Settings → Project: 你的项目名称 → Python Interpreter
• 点击右上角齿轮图标选择Add，选中对应Python环境，确认列表中存在opencv-python包
• 如果列表无相关包，直接点击当前界面的+号，搜索opencv-python点击安装即可，不会出现环境不匹配问题

3 特殊情况处理 #

你之前添加路径的代码存在语法错误，缺少末尾的单引号，正确写法为：
sys.path.append('/usr/local/lib/python39/site-packages')
不建议硬编码添加路径，该方法仅做临时验证使用，优先完成前两步配置即可解决绝大多数问题。

报错参考截图 #

内容的提问来源于stack exchange，提问作者us3-r