Mac系统下Atom无法导入opencv-python模块的问题求助

这个问题十有八九是Atom使用的Python环境和你终端里pip3安装opencv的环境不匹配导致的，下面是一步步的排查和解决方法：

• 第一步：确认终端的Python环境确实有opencv
  打开终端，依次运行这两个命令：

  which python3
  python3 -c "import cv2; print(cv2.__version__)"
  

  第一个命令会输出你终端用的Python3的路径（比如/usr/local/bin/python3或者/Users/xxx/.pyenv/shims/python3），第二个命令如果能正常打印opencv版本，说明终端环境没问题。

• 第二步：检查Atom的脚本运行环境
  如果你是用Atom的script插件来运行代码的，需要确保它用的Python路径和终端一致：

  1. 打开Atom的设置（快捷键Cmd+,）
  2. 在左侧找到script插件，点击进入设置页面
  3. 找到Command选项，把它设置成你第一步得到的Python3路径，或者直接填python3（如果终端的python3在系统PATH里）
  4. 另外，也可以在插件的Python子设置里，确认默认的解释器是Python3

• 第三步：临时解决方法（直接指定解释器）
  如果你不想改插件设置，可以在你的Python脚本最开头加上一行shebang，指定用终端的Python3来运行：

  #!/usr/bin/env python3
  import cv2
  # 你的其他代码
  

  保存文件后，打开终端，给脚本加上执行权限：

  chmod +x your_script.py
  

  之后在Atom里运行脚本时，就会用指定的Python3环境了。

• 第四步：排查虚拟环境的影响
  如果你之前用了虚拟环境（比如venv、conda），要确保：

  1. 你是在激活虚拟环境后安装的opencv
  2. Atom运行脚本时，也处于同一个虚拟环境中（可以在终端激活虚拟环境后，从终端启动Atom：open -a Atom，这样Atom就会继承终端的环境变量）

按照上面的步骤来，应该就能解决导入cv2的问题了。

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