已安装OpenCV但Sublime Text/终端导入失败，IDLE却正常？

这种环境不一致的坑我踩过好多次了！你遇到的问题本质是：OpenCV只安装在了IDLE对应的Python环境里，但Sublime Text或终端用的是另一个完全独立的Python环境，所以才会报ModuleNotFoundError: No module named 'opencv-python'（另外提一句：导入OpenCV的正确写法是import cv2，不是openCV，你IDLE能运行应该是笔误~）。

下面是具体的排查和解决步骤：

第一步：确认各个环境的Python路径 #

先搞清楚不同工具用的是哪个Python解释器：

• 在IDLE里运行这段代码：

  import sys
  print(sys.executable)
  

  记下输出的路径（比如Linux/macOS的/usr/local/bin/python3.9，Windows的C:\Python39\python.exe），这是装了OpenCV的正确环境。
• 在终端里运行同样的代码，对比输出路径和IDLE的是否一致。
• 在Sublime Text里新建一个测试脚本，粘贴上面的代码，按Ctrl+B（Windows/Linux）或Cmd+B（macOS）运行，查看输出路径。

第二步：针对不同场景解决问题 #

场景1：终端运行报错 #

如果终端的Python路径和IDLE不一样，有两种解决方式：

• 给正确的环境重新装OpenCV：在终端里用IDLE对应的Python解释器执行pip安装，比如：

  # 把路径换成你刚才记下的IDLE的Python路径
  /usr/local/bin/python3.9 -m pip install opencv-python
  

• 用正确的解释器运行脚本：以后运行代码时，直接指定IDLE的Python路径，比如：

  /usr/local/bin/python3.9 your_script.py
  

场景2：Sublime Text运行报错 #

需要让Sublime Text使用IDLE对应的Python环境：

1. 打开Sublime Text，点击顶部菜单 Tools -> Build System -> New Build System
2. 清空默认内容，粘贴下面的配置（把"cmd"里的路径换成你IDLE的Python路径）：

   {
       "cmd": ["/usr/local/bin/python3.9", "-u", "$file"],
       "file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
       "selector": "source.python",
       "env": {"PYTHONIOENCODING": "utf8"}
   }
   

3. 保存文件，命名为Python-IDLE.sublime-build（保存位置默认即可）
4. 回到Sublime Text，点击 Tools -> Build System，选中你刚创建的Python-IDLE
5. 现在运行你的OpenCV脚本，应该就能正常导入了

额外小提示 #

• 如果你用了虚拟环境，要确保在终端激活了装了OpenCV的虚拟环境，或者在Sublime的构建系统里指定虚拟环境的Python路径。
• 平时可以用which python（Linux/macOS）或者where python（Windows）快速查看终端默认的Python路径，方便对比排查。

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