在Python中安装PyTorch,核心是根据自己的硬件(有无NVIDIA GPU)和操作系统选择正确的安装命令。
为了帮助你快速决策,我将主要安装方式整理为下表:
| 安装方式 | 适用场景 | 核心命令 (以CUDA 11.8为例) | 优点 | 注意事项 |
|---|---|---|---|---|
| Conda 安装 | 大多数用户,尤其初学者;需要自动管理依赖和环境隔离。 | conda install pytorch torchvision torchaudio pytorch-cuda=11.8 -c pytorch -c nvidia | 自动解决CUDA等复杂依赖;易于创建隔离环境。 | 安装包体积较大。国内用户建议配置清华源加速。 |
| Pip 安装 | 习惯使用pip;需要更灵活地控制版本。 | pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118 | 安装包相对较小;与Python生态集成更直接。 | 需自行确保CUDA等系统级依赖已安装。 |
| CPU版本(conda安装) | 无NVIDIA显卡,或仅运行轻量级推理。 | conda install pytorch torchvision torchaudio cpuonly -c pytorch | 安装简单,无需考虑GPU驱动。 | 无法进行GPU加速,训练大型模型速度慢。 |
| CPU版本(pip安装) | 无NVIDIA显卡,或仅运行轻量级推理。 | pip install torch torchvision torchaudio | 安装简单,无需考虑GPU驱动。 | 无法进行GPU加速,训练大型模型速度慢。 |
🔍 如何选择与安装
你可以按照以下步骤进行操作:
-
确认安装前提
- Python版本:建议使用 Python 3.8 至 3.11。Python 3.12可能因适配问题导致安装失败。
- 使用虚拟环境:强烈推荐使用
conda或venv创建独立的虚拟环境,避免包冲突。例如:conda create -n pytorch_env python=3.10 conda activate pytorch_env - 检查GPU(仅GPU版本需要):
- 在命令行输入
nvidia-smi,查看显卡驱动版本和最高支持的CUDA版本。 - 根据驱动支持的CUDA版本,选择对应的PyTorch安装命令。例如,若驱动支持CUDA 12.x,通常可以安装
cu118版本的PyTorch,因为CUDA是向下兼容的。
- 在命令行输入
-
获取安装命令 访问 PyTorch官网,使用官网的配置工具生成最准确的命令。
- 选择 PyTorch Version(建议Stable)。
- 选择你的操作系统。
- 选择 Package(Conda或Pip)。
- 选择 Language(Python)。
- 选择 Compute Platform(CUDA版本或CPU)。
- 复制底部生成的命令运行。
-
验证安装 安装完成后,运行以下Python代码验证:
import torch print(torch.__version__) # 查看版本 print(torch.cuda.is_available()) # GPU版本应返回True,CPU版本返回False
⚠️ 安装注意事项
- 版本匹配是关键:确保PyTorch版本、CUDA版本(如有)、Python版本三者兼容。不匹配是安装失败最常见的原因。
- 网络问题:下载速度慢或超时,可以使用国内镜像源加速。
- 权限问题:避免直接使用
sudo pip install进行全局安装,以免污染系统环境。应在虚拟环境中安装。
💡 常见问题排查
torch.cuda.is_available()返回 False:- 检查CUDA版本是否匹配:
nvcc --version(CUDA编译器版本) 应与安装命令指定版本一致。 - 检查显卡驱动:确保
nvidia-smi能正确显示驱动信息且版本足够新。 - 检查环境变量:确保CUDA路径(如
/usr/local/cuda/bin)已添加到系统PATH中。
- 检查CUDA版本是否匹配:
- 导入错误或依赖问题:在虚拟环境中,尝试使用
conda重新安装,它更能处理复杂依赖。
📚 后续学习建议
安装成功后,你可以尝试:
- 运行官网的60分钟入门教程。
- 在PyCharm或VS Code中配置刚创建的虚拟环境作为项目解释器,方便开发。
如果你能告诉我你的操作系统(如Windows 11)、是否有NVIDIA显卡、以及打算用它来做什么(如学习、科研),我可以给你更具体的建议。