已安装ultralytics仍报ModuleNotFoundError的修复方案咨询

• 确认pip与Python的对应关系
  多数情况是安装模块的pip和运行程序的Python版本不匹配，按以下步骤验证：

  1. 在Python代码开头添加：import sys; print(sys.executable)，运行后得到当前程序使用的Python路径（比如/usr/bin/python3或C:\Python310\python.exe）
  2. 使用该路径对应的pip重新安装模块，示例命令：/usr/bin/python3 -m pip install ultralytics，确保用的是同一个Python环境的pip

• 检查虚拟环境激活状态
  若使用了虚拟环境，运行程序前必须激活对应环境：

  • Windows系统：执行venv\Scripts\activate
  • Linux/macOS系统：执行source venv/bin/activate
    激活后重新安装模块并运行程序

• 手动添加模块路径
  如果模块安装在非标准位置，可在代码开头手动添加路径：

  import sys
  sys.path.append("/path/to/ultralytics")  # 替换为`pip show ultralytics`输出中Location字段的路径
  from ultralytics import YOLO
  

  执行pip show ultralytics可查看模块的安装位置

• 清理缓存后重装
  缓存异常可能导致安装失效，执行以下步骤：

  1. 卸载模块：pip uninstall -y ultralytics
  2. 清理pip缓存：pip cache purge
  3. 无缓存重装：pip install ultralytics --no-cache-dir

• 检查IDE的解释器配置
  若使用VSCode、PyCharm等IDE，需确保IDE选择的Python解释器与安装模块的解释器一致：

  • VSCode：按Ctrl+Shift+P（Windows）/Cmd+Shift+P（macOS），输入Python: Select Interpreter，选择对应环境
  • PyCharm：依次点击File > Settings > Project: 你的项目名 > Python Interpreter，选择正确的解释器

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