安装ultralytics后导入YOLO出现OSError[WinError126]的解决咨询

报错信息 #

---------------------------------------------------------------------------
OSError                                   Traceback (most recent call last)
Cell In[2], line 4
      2 import pandas as pd
      3 import numpy as np
----> 4 from ultralytics import YOLO

File c:\Users\tate5.DESKTOP-BQ3MNS0\Desktop\footfall\myenv\Lib\site-packages\ultralytics\__init__.py:10
      7 # Set ENV Variables (place before imports)
      8 os.environ["OMP_NUM_THREADS"] = "1"  # reduce CPU utilization during training
---> 10 from ultralytics.data.explorer.explorer import Explorer
     11 from ultralytics.models import NAS, RTDETR, SAM, YOLO, FastSAM, YOLOWorld
     12 from ultralytics.utils import ASSETS, SETTINGS

File c:\Users\tate5.DESKTOP-BQ3MNS0\Desktop\footfall\myenv\Lib\site-packages\ultralytics\data\__init__.py:3
      1 # Ultralytics YOLO 🚀, AGPL-3.0 license
----> 3 from .base import BaseDataset
      4 from .build import build_dataloader, build_grounding, build_yolo_dataset, load_inference_source
      5 from .dataset import (
      6     ClassificationDataset,
      7     GroundingDataset,
   (...)
     11     YOLOMultiModalDataset,
     12 )
...
--> 148                 raise err
    150     kernel32.SetErrorMode(prev_error_mode)
    153 def _preload_cuda_deps(lib_folder, lib_name):

OSError: [WinError 126] The specified module could not be found. Error loading

问题原因 #

这类错误通常和以下几点相关：

• 系统缺少必要的VC++运行库
• CUDA依赖库缺失或版本不兼容
• 虚拟环境中的依赖安装不完整或损坏

修复步骤 #

1. 安装/更新VC++ Redistributable #

Windows系统下多数Python库依赖Microsoft Visual C运行库，直接下载x64版本的**Microsoft Visual C Redistributable**安装，完成后重启电脑。

2. 重新安装依赖库 #

先彻底卸载现有相关包，再根据需求选择CPU或GPU版本重新安装：

• 卸载命令：

  pip uninstall -y ultralytics torch torchvision
  

• 安装CPU版本：

  pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu
  pip install ultralytics
  

• 安装GPU版本（需先确认系统已安装对应版本的CUDA驱动，比如CUDA 11.8）：

  pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118
  pip install ultralytics
  

3. 验证CUDA配置（GPU用户） #

运行以下代码检查CUDA是否可用：

import torch
print(torch.cuda.is_available())

如果输出True说明CUDA配置正常；如果是False，检查CUDA驱动是否正确安装，或者切换到CPU版本的PyTorch。

4. 重建虚拟环境 #

如果虚拟环境损坏，直接删除现有虚拟环境文件夹（比如myenv），重新创建并安装依赖：

# 删除旧环境后，创建新环境
python -m venv myenv
# 激活环境（Windows命令行）
myenv\Scripts\activate
# 安装基础包
pip install pandas numpy
# 再按步骤2安装PyTorch和Ultralytics

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