Windows下PyTorch环境搭建指南

 更新时间:2026年04月08日 09:29:35   作者:fundoit  
本文提供了Windows系统下PyTorch的完整安装指南,包括三种方式使用Conda(推荐)、Pip以及国内镜像源加速,并附有具体命令,最后针对常见问题如属性错误、CUDA版本不匹配等提供了解决方案,具有一定的参考价值,感兴趣的可以了解一下

一、环境介绍

PyTorch 系统要求

推荐配置参考

组件推荐配置说明
CPUIntel i7 或同级以上建议 8 核心以上
显卡NVIDIA RTX 2060 及以上显存建议 8GB+
操作系统Windows 10/11 64位确保系统更新到最新版本
Anaconda最新版本便于环境管理
CUDA Toolkit11.8 / 12.1 / 12.6根据显卡驱动选择
cuDNN8.x 系列与 CUDA 版本匹配
Python3.10 / 3.11稳定性较好
PyTorch2.2.2 / 2.8.0根据需求选择稳定版或最新版

二、安装前准备

1. 检查显卡驱动

在安装 CUDA 之前,请确保显卡驱动已更新到最新版本:

# Windows 命令行查看显卡信息
nvidia-smi

2. 确定 CUDA 版本

# 查看已安装的 CUDA 版本
nvcc -V

3. 版本匹配参考

PyTorch 版本CUDA 版本Python 版本适用场景
2.8.012.63.11+最新特性,新显卡
2.2.212.13.10-3.11稳定版本,兼容性好
2.2.211.83.8-3.11旧显卡,广泛兼容
2.2.2CPU3.8-3.11无独立显卡

三、安装教程

方案一:使用 Conda 安装(推荐)

# 创建新环境
conda create -n pytorch python=3.11
conda activate pytorch
# CUDA 11.8 版本
conda install pytorch==2.2.2 torchvision==0.17.2 torchaudio==2.2.2 pytorch-cuda=11.8 -c pytorch -c nvidia
# CUDA 12.1 版本
conda install pytorch==2.2.2 torchvision==0.17.2 torchaudio==2.2.2 pytorch-cuda=12.1 -c pytorch -c nvidia
# CUDA 12.6 版本
conda install pytorch torchvision torchaudio pytorch-cuda=12.6 -c pytorch -c nvidia

方案二:使用 Pip 安装

# CUDA 11.8
pip install torch==2.2.2 torchvision==0.17.2 torchaudio==2.2.2 --index-url https://download.pytorch.org/whl/cu118
# CUDA 12.1
pip install torch==2.2.2 torchvision==0.17.2 torchaudio==2.2.2 --index-url https://download.pytorch.org/whl/cu121
# CUDA 12.6
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu126
# CPU 版本(无显卡)
pip install torch==2.2.2 torchvision==0.17.2 torchaudio==2.2.2 --index-url https://download.pytorch.org/whl/cpu

方案三:使用国内镜像源加速

# 清华镜像源
pip install torch==2.2.2 torchvision==0.17.2 torchaudio==2.2.2 -i https://pypi.tuna.tsinghua.edu.cn/simple
# 安装常用依赖
pip install facenet-pytorch -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install matplotlib -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install numpy==1.26.4 -i https://pypi.tuna.tsinghua.edu.cn/simple
# 安装 dlib(需要 conda)
conda install -c conda-forge dlib
# 安装 face-recognition
pip install face-recognition -i https://pypi.tuna.tsinghua.edu.cn/simple

Conda 常用命令

# 搜索可用版本
conda search pytorch -c pytorch
conda search pytorch-cuda -c pytorch -c nvidia
# 查看通道配置
conda config --show
# 添加通道
conda config --add channels 通道地址
# 删除环境
conda remove --name 环境名称 --all
conda remove --prefix 路径 --all
# 卸载包
pip uninstall torch torchvision torchaudio
# 查看已安装包
conda list

四、环境验证

1. 快速验证

# 命令行验证
python -c "import torch; print(torch.__version__)"
python -c "import torch; print(torch.cuda.is_available())"

2. Python 脚本验证

import torch

print(f"PyTorch 版本:{torch.__version__}")
print(f"CUDA 可用:{torch.cuda.is_available()}")

if torch.cuda.is_available():
    print(f"CUDA 版本:{torch.version.cuda}")
    print(f"GPU 数量:{torch.cuda.device_count()}")
    print(f"当前 GPU:{torch.cuda.get_device_name(0)}")

3. CPU 测试

import torch

# 创建随机张量
x = torch.rand(5, 3)
print(x)
print(f"设备:{x.device}")

4. GPU 完整测试

import torch
import torch.nn as nn

# 检查 CUDA 是否可用
if torch.cuda.is_available():
    device = torch.device("cuda")
    print("✓ 运行在 GPU 上")
else:
    device = torch.device("cpu")
    print("✓ 运行在 CPU 上")

# 创建模型并移动到设备
model = nn.Linear(10, 5).to(device)

# 创建输入数据
x = torch.randn(3, 10).to(device)

# 执行前向传播
output = model(x)

print(f"输出设备:{output.device}")
print(f"输出形状:{output.shape}")
print(f"输出值:\n{output}")

五、常见问题与解决方案

问题 1:torch.accelerator属性错误

错误信息

AttributeError: module 'torch' has no attribute 'accelerator'

原因torch.accelerator 属性在低版本 PyTorch 中未定义。

解决方案

# ❌ 错误写法
device = torch.accelerator.current_accelerator().type if torch.accelerator.is_available() else "cpu"
# ✅ 正确写法 1
device = "cuda" if torch.cuda.is_available() else "cpu"
# ✅ 正确写法 2
device = torch.device("cuda" if torch.cuda.is_available() else "cpu")
print(device)  # 输出:cuda:0 或 cpu

问题 2:CUDA 版本不匹配

症状:安装后 torch.cuda.is_available() 返回 False

解决方案

  1. 检查显卡驱动版本是否支持所选 CUDA 版本
  2. 重新安装匹配的 CUDA Toolkit
  3. 使用以下命令确认:
    nvidia-smi  # 查看驱动支持的最高 CUDA 版本

问题 3:安装速度慢

解决方案

# 使用清华镜像
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 包名
# 使用阿里镜像
pip install -i https://mirrors.aliyun.com/pypi/simple/ 包名
# 配置永久镜像源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

问题 4:dlib 安装失败

解决方案

# 先安装 CMake
conda install -c conda-forge cmake
# 再安装 dlib
conda install -c conda-forge dlib
# 最后安装 face-recognition
pip install face-recognition

问题 5:环境冲突

解决方案

# 完全卸载
pip uninstall torch torchvision torchaudio
# 清理缓存
pip cache purge
# 重新创建环境
conda remove --name pytorch --all
conda create -n pytorch python=3.11
conda activate pytorch

六、代码示例

官方代码仓库

基础示例

# 1. 张量操作
import torch
x = torch.tensor([1, 2, 3])
y = torch.tensor([4, 5, 6])
print(x + y)  # 张量加法
# 2. 自动求导
x = torch.tensor([2.0], requires_grad=True)
y = x ** 2
y.backward()
print(x.grad)  # 输出:4.0
# 3. 神经网络
import torch.nn as nn
class Net(nn.Module):
    def __init__(self):
        super().__init__()
        self.fc1 = nn.Linear(10, 5)
        self.fc2 = nn.Linear(5, 2)
    def forward(self, x):
        x = torch.relu(self.fc1(x))
        x = self.fc2(x)
        return x
model = Net()
print(model)

附录:版本选择建议

使用场景推荐配置
学习入门PyTorch 2.2.2 + CUDA 11.8 + Python 3.10
生产环境PyTorch 2.2.2 + CUDA 12.1 + Python 3.11
最新特性PyTorch 2.8.0 + CUDA 12.6 + Python 3.11+
无独立显卡PyTorch CPU 版本 + Python 3.11
旧显卡支持PyTorch 2.2.2 + CUDA 11.2 + Python 3.9

提示:建议定期关注 PyTorch 官方更新,及时升级以获得更好的性能和安全性。如有问题,优先查阅官方文档或在社区寻求帮助。

到此这篇关于Windows下PyTorch环境搭建指南的文章就介绍到这了,更多相关PyTorch 环境搭建内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Python实现的json文件读取及中文乱码显示问题解决方法

    Python实现的json文件读取及中文乱码显示问题解决方法

    这篇文章主要介绍了Python实现的json文件读取及中文乱码显示问题解决方法,涉及Python针对json文件的读取载入、编码转换等相关操作技巧,需要的朋友可以参考下
    2018-08-08
  • flask框架中勾子函数的使用详解

    flask框架中勾子函数的使用详解

    这篇文章主要介绍了flask框架中勾子函数的使用详解,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-08-08
  • python 在右键菜单中加入复制目标文件的有效存放路径(单斜杠或者双反斜杠)

    python 在右键菜单中加入复制目标文件的有效存放路径(单斜杠或者双反斜杠)

    这篇文章主要介绍了python 在右键菜单中加入复制目标文件的有效存放路径(单斜杠或者双反斜杠),本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-04-04
  • Python安装Graphviz 超详细图文教程

    Python安装Graphviz 超详细图文教程

    这篇文章主要介绍了Python安装Graphviz 详细教程,在Python安装Graphviz画图器,首先要明确他是一个独立的软件,如果大家用pip的方法装了graphviz可以先卸载,本文通过图文并茂的形式详细讲解,需要的朋友参考下吧
    2023-02-02
  • 从入门到精通详解Python虚拟环境完全指南

    从入门到精通详解Python虚拟环境完全指南

    Python虚拟环境是一个独立的Python运行环境,它允许你为不同的项目创建隔离的Python环境,下面小编就来和大家详细介绍一下吧
    2025-08-08
  • 基于python3实现socket文件传输和校验

    基于python3实现socket文件传输和校验

    这篇文章主要为大家详细介绍了基于python3实现socket文件传输和校验,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-07-07
  • Python中subplots_adjust函数的用法

    Python中subplots_adjust函数的用法

    这篇文章主要介绍了Python中subplots_adjust函数的用法及说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-08-08
  • 基于Python实现计算纳什均衡的示例详解

    基于Python实现计算纳什均衡的示例详解

    纳什均衡是一种博弈论中的概念,它描述了一种平衡状态,其中每个参与者都不能通过独立改变其决策来提高自己的利益。本文就来用Python中的Nashpy和PuLP实现计算纳什均衡,感兴趣的可以了解一下
    2023-02-02
  • 解决TensorFlow训练内存不断增长,进程被杀死问题

    解决TensorFlow训练内存不断增长,进程被杀死问题

    今天小编就为大家分享一篇解决TensorFlow训练内存不断增长,进程被杀死问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-02-02
  • python矩阵的基本运算及各种操作

    python矩阵的基本运算及各种操作

    python的numpy库提供矩阵运算的功能,因此我们在需要矩阵运算的时候,需要导入numpy的包,下面这篇文章主要给大家介绍了关于python矩阵的基本运算及各种操作的相关资料,需要的朋友可以参考下
    2022-11-11

最新评论