PyTorch 安装中 OSError: [WinError 1114] 动态链接库初始化失败的解决方案

问题场景

某开发者在 Windows 环境下使用 uv 包管理器创建了 Python 虚拟环境，并安装了 PyTorch、torchvision、torchaudio。但在运行代码时，遇到了以下错误：

OSError: [WinError 1114] 动态链接库(DLL)初始化例程失败。 
Error loading "...\site-packages\torch\lib\c10.dll" or one of its dependencies.

同时，执行简单的 import torch 也会触发此异常，导致无法使用 PyTorch。

错误原因分析

c10.dll 是 PyTorch 的核心依赖库，其加载失败通常由以下原因之一引起：

1. 缺少或损坏的 Visual C++ Redistributable 运行库：Windows 下编译的 PyTorch 需要 vcruntime140.dll 等 VC++ 运行时，若系统未安装或版本不符，则 DLL 初始化失败。
2. PyTorch 版本与当前 Python 版本不兼容：例如 Python 3.12+ 可能没有对应的预编译 wheel，或者包的依赖链不完整。

解决方案（分两步，逐步尝试）

按照先后顺序执行以下两个方案，通常可解决问题。

第一步：安装/修复 Visual C++ Redistributable（成功率最高）

1. 下载 Visual C++ Redistributable（最新版）：
   • 微软官网搜索 “Latest supported Visual C++ Redistributable” 或直接下载 vc_redist.x64.exe。
2. 如果已安装旧版本，可以选择“修复”安装；否则直接安装。
3. 重启计算机（关键步骤）。
4. 重新激活 Python 虚拟环境，测试 import torch。

若此步后问题依然存在，请继续执行第二步。

第二步：使用 CPU 版本的 PyTorch（稳定且依赖少）

若不需要 GPU 加速，CPU 版本通常不会出现 DLL 问题：

# 卸载原有的 PyTorch 相关包
uv pip uninstall torch torchvision torchaudio

# 安装 CPU-only 版本（从官方 CPU 索引）
uv pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu

安装后测试：

import torch
print(torch.__version__)   # 输出如 2.11.0+cpu
print(torch.cuda.is_available())  # 返回 False

说明：以上两步已经能够解决本案例中的问题。其他方案（如降级版本、使用 Conda 等）暂未尝试，故不在此列出。

验证步骤

执行如下测试脚本，确认 PyTorch 可以正常导入：

try:
    import torch
    print(f"✅ PyTorch 加载成功！版本：{torch.__version__}")
    print(f"✅ CUDA 状态：{torch.cuda.is_available()}（CPU版显示False正常）")
    print(f"✅ CUDA 设备数：{torch.cuda.device_count()}")
except Exception as e:
    print(f"❌ 加载失败：{e}")

正常输出（CPU 版）示例：

✅ PyTorch 加载成功！版本：2.11.0+cpu
✅ CUDA 状态：False（CPU版显示False正常）
✅ CUDA 设备数：0

常见问题 FAQ

Q: 为什么安装时出现硬链接警告（Failed to hardlink files）？
A: 通常是因为 uv 缓存目录与项目目录不在同一磁盘分区（如 C 盘和 D 盘），回退到完整复制不影响功能，可以忽略。设置 UV_LINK_MODE=copy 可消除警告。

Q: 已经安装了 VC++ 运行库，为什么还是报 1114？
A: 建议尝试“修复”安装，并确保重启。部分 Windows 更新也可能导致运行时版本错乱，可尝试卸载后重新安装 VC++。

总结

OSError: [WinError 1114] 是 Windows 下 PyTorch 环境配置中的常见问题，根本原因是系统缺少必要的 VC++ 运行库或依赖不完整。按顺序执行：先修复 VC++ 运行库，再切换到 CPU 版本 PyTorch，即可顺利解决问题。