PyTorch 2.2.1 离线安装：Windows 10/11 环境 9 个依赖包手动安装顺序详解

发布时间：2026/7/10 3:40:57

PyTorch 2.2.1 离线安装：Windows 环境依赖包安装顺序与深度解析

在企业级开发环境中，离线安装PyTorch是许多IT管理员和算法工程师必须掌握的技能。不同于常规的网络安装，离线环境下的依赖管理往往成为最大的挑战。本文将深入剖析PyTorch 2.2.1在Windows 10/11系统中的9个关键依赖包安装顺序，并提供一套经过验证的解决方案。

1. 离线安装的核心挑战与准备工作

离线环境下安装PyTorch远比在线安装复杂，主要原因在于依赖关系的复杂性。PyTorch作为一个深度学习框架，其功能模块依赖于多个第三方库，这些库之间又存在复杂的依赖链。在没有网络连接的环境中，任何依赖缺失或安装顺序错误都可能导致整个安装过程失败。

1.1 环境准备清单

在开始安装前，请确保准备好以下内容：

Python环境：推荐使用Python 3.10.x版本，这是PyTorch 2.2.1官方测试最充分的版本
Anaconda：用于创建隔离的Python环境，避免与系统Python冲突
下载好的whl文件包：包括PyTorch主包及其所有依赖

提示：建议将所有whl文件放在同一目录下，如D:\pytorch_packages，便于管理

1.2 依赖关系解析工具

虽然离线环境无法使用pip的依赖解析功能，但我们可以在联网机器上预先检查依赖关系：

pip download torch==2.2.1 --no-deps pip show torch

这将显示PyTorch的核心依赖要求，帮助我们确定必须手动安装的包列表。

2. 关键依赖包安装顺序详解

经过多次实践验证，以下是PyTorch 2.2.1在Windows系统下的9个核心依赖包及其最优安装顺序：

2.1 基础依赖层安装

这一层的包不依赖其他PyTorch相关包，应最先安装：

filelock (3.13.1)- 提供文件锁定功能，确保多进程安全
```
pip install filelock-3.13.1-py3-none-any.whl
```

typing-extensions (4.10.0)- 类型提示扩展支持

pip install typing_extensions-4.10.0-py3-none-any.whl

mpmath (1.3.0)- 高精度数学计算库

pip install mpmath-1.3.0-py3-none-any.whl

2.2 中级依赖层安装

这些包依赖于基础层，但不会被其他PyTorch核心包依赖：

sympy (1.12)- 符号数学库
```
pip install sympy-1.12-py3-none-any.whl
```

networkx (3.2.1)- 图结构处理库

pip install networkx-3.2.1-py3-none-any.whl

2.3 高级依赖层安装

这些包可能被多个PyTorch组件依赖，需要在中级层之后安装：

MarkupSafe (2.1.5)- HTML/XML安全处理库

pip install MarkupSafe-2.1.5-cp310-cp310-win_amd64.whl

Jinja2 (3.1.3)- 模板引擎

pip install Jinja2-3.1.3-py3-none-any.whl

fsspec (2024.3.1)- 统一文件系统接口

pip install fsspec-2024.3.1-py3-none-any.whl

2.4 主包安装

在所有依赖就绪后，最后安装PyTorch主包：

torch (2.2.1)- PyTorch核心库

pip install torch-2.2.1-cp310-cp310-win_amd64.whl

3. 依赖关系可视化与冲突解决

3.1 依赖关系图

以下是简化后的依赖关系示意图：

filelock typing-extensions | | | | v v mpmath -> sympy <- networkx | v MarkupSafe <- Jinja2 | v fsspec | v torch

3.2 常见冲突解决方案

在实际安装过程中，可能会遇到以下问题：

版本冲突：如果提示某个包已存在但版本不匹配，使用：
```
pip install --force-reinstall [包名]
```
依赖缺失：即使按照顺序安装，仍可能提示缺少依赖，通常是因为：
- 某些系统级依赖未安装（如Visual C++ Redistributable）
- Python环境不纯净（建议使用conda新建环境）
文件损坏：下载的whl文件可能不完整，可通过校验文件大小确认：
```
dir *.whl
```

4. 完整安装后的验证与优化

4.1 安装验证

安装完成后，运行以下Python代码验证：

import torch print(torch.__version__) # 应输出2.2.1 t = torch.tensor([[1,2],[3,4]]) print(t.device) # 应显示cpu或cuda

4.2 后续组件安装

PyTorch核心安装完成后，可按需安装：

torchvision：计算机视觉扩展

pip install torchvision-0.17.1-cp310-cp310-win_amd64.whl

torchaudio：音频处理扩展

pip install torchaudio-2.2.1-cp310-cp310-win_amd64.whl

4.3 环境优化建议

设置环境变量提升性能：

set OMP_NUM_THREADS=4 set MKL_NUM_THREADS=4

对于长期运行的服务器，建议固定Python环境：
```
pip freeze > requirements.txt
```

5. 企业级部署的最佳实践

在企业环境中部署PyTorch时，还需要考虑以下因素：

批量部署脚本：将安装过程编写为批处理脚本，确保一致性
版本控制：严格记录所有组件的版本信息
备用方案：准备不同Python版本的whl文件包
权限管理：在受限权限环境中，可能需要使用--user参数

以下是一个完整的安装脚本示例：

@echo off set PACKAGE_DIR=D:\pytorch_packages cd %PACKAGE_DIR% pip install filelock-3.13.1-py3-none-any.whl pip install typing_extensions-4.10.0-py3-none-any.whl pip install mpmath-1.3.0-py3-none-any.whl pip install sympy-1.12-py3-none-any.whl pip install networkx-3.2.1-py3-none-any.whl pip install MarkupSafe-2.1.5-cp310-cp310-win_amd64.whl pip install Jinja2-3.1.3-py3-none-any.whl pip install fsspec-2024.3.1-py3-none-any.whl pip install torch-2.2.1-cp310-cp310-win_amd64.whl echo PyTorch安装完成，开始验证... python -c "import torch; print(f'PyTorch版本: {torch.__version__}')"

通过遵循本文提供的安装顺序和解决方案，即使在最严格的离线环境中，也能成功部署PyTorch开发环境。这套方案已在多个企业级项目中验证，能够有效避免常见的依赖冲突问题。