入门

选择偏好并运行命令以在本地安装 PyTorch,或通过支持的云平台快速入门。

快捷方式

    本地启动

    选择您的偏好设置并运行安装命令。Stable 代表 PyTorch 最新的经过测试和支持的版本。这应该适合大多数用户。如果您想要最新的、未经充分测试和支持的、每晚生成的构建,可以使用 Preview。请确保您已 满足以下先决条件(例如 numpy),具体取决于您的包管理器。您也可以 安装 PyTorch 的先前版本。请注意,LibTorch 仅适用于 C++。

    注意:最新稳定版 PyTorch 需要 Python 3.10 或更高版本。

    PyTorch 版本
    您的操作系统
    语言
    计算平台
    运行此命令
    PyTorch 版本
    稳定版 (2.7.0)
    预览版(夜间构建)
    您的操作系统
    Linux
    Mac
    Windows
    Pip
    LibTorch
    源代码
    语言
    Python
    C++ / Java
    计算平台
    CUDA 11.8
    CUDA 12.6
    CUDA 12.8
    ROCm 6.3
    CPU
    运行此命令
    pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118


    在 macOS 上安装

    PyTorch 可以在 macOS 上安装和使用。根据您的系统和 GPU 功能,您在 macOS 上使用 PyTorch 的处理时间可能会有所不同。

    先决条件

    macOS 版本

    PyTorch 支持 macOS 10.15 (Catalina) 或更高版本。

    Python

    建议您使用 Python 3.10 - 3.14。您可以通过 HomebrewPython 网站 安装 Python。

    包管理器

    要安装 PyTorch 二进制文件,您需要使用受支持的包管理器: pip

    pip

    Python 3

    如果您通过 Homebrew 或 Python 网站安装了 Python,则 pip 随之安装。如果您安装了 Python 3.x,那么您将使用命令 pip3

    提示:如果您想仅使用 pip 命令而不是 pip3,可以将 pip 链接到 pip3 二进制文件。

    安装

    pip

    要通过 pip 安装 PyTorch,请根据您的 Python 版本使用以下命令

    # Python 3.x
    pip3 install torch torchvision
    

    验证

    为确保 PyTorch 安装正确,我们可以通过运行示例 PyTorch 代码来验证安装。这里我们将构建一个随机初始化的张量。

    import torch
    x = torch.rand(5, 3)
    print(x)
    

    输出应类似于

    tensor([[0.3380, 0.3845, 0.3217],
            [0.8337, 0.9050, 0.2650],
            [0.2979, 0.7141, 0.9069],
            [0.1449, 0.1132, 0.1375],
            [0.4675, 0.3947, 0.1426]])
    

    从源代码构建

    对于大多数 PyTorch 用户来说,通过包管理器安装预构建的二进制文件将提供最佳体验。但是,有时您可能希望安装最新的 PyTorch 代码,无论是用于测试还是实际开发 PyTorch 核心。要安装最新的 PyTorch 代码,您需要 从源代码构建 PyTorch

    先决条件

    1. [可选] 安装 pip
    2. 请遵循此处描述的步骤: https://github.com/pytorch/pytorch#from-source

    您可以按照 上方 的描述验证安装。

    在 Linux 上安装

    PyTorch 可以在各种 Linux 发行版上安装和使用。根据您的系统和计算需求,您在 Linux 上使用 PyTorch 的处理时间可能会有所不同。建议(但非必需)您的 Linux 系统拥有 NVIDIA 或 AMD GPU,以便充分利用 PyTorch 的 CUDA 支持ROCm 支持。

    先决条件

    支持的 Linux 发行版

    PyTorch 支持使用 glibc >= v2.28 的 Linux 发行版,包括以下发行版:

    此处提供的安装说明通常适用于所有支持的 Linux 发行版。一个示例差异是,您的发行版可能支持 yum 而不是 apt。所示的具体示例是在 Ubuntu 18.04 机器上运行的。

    Python

    Python 3.10-3.14 通常在我们的任何支持的 Linux 发行版上默认安装,这符合我们的建议。

    提示:默认情况下,您必须使用命令 python3 来运行 Python。如果您想仅使用 python 命令而不是 python3,可以将 python 链接到 python3 二进制文件。

    但是,如果您想安装其他版本,有多种方法:

    如果您决定使用 APT,可以运行以下命令进行安装:

    sudo apt install python
    

    包管理器

    要安装 PyTorch 二进制文件,您需要使用受支持的包管理器: pip

    pip

    Python 3

    虽然 Python 3.x 在 Linux 上默认安装,但 pip 默认不安装。

    sudo apt install python3-pip
    

    提示:如果您想仅使用 pip 命令而不是 pip3,可以将 pip 链接到 pip3 二进制文件。

    安装

    pip

    无 CUDA

    要通过 pip 安装 PyTorch,并且您没有 支持 CUDA 的支持 ROCm 的 系统,或者不需要 CUDA/ROCm(即 GPU 支持),请在上面的选择器中选择 OS: Linux, Package: Pip, Language: Python 和 Compute Platform: CPU。然后,运行显示的命令。

    带 CUDA

    要通过 pip 安装 PyTorch,并且您拥有 支持 CUDA 的 系统,请在上面的选择器中选择 OS: Linux, Package: Pip, Language: Python 和适合您机器的 CUDA 版本。通常,最新版本的 CUDA 更好。然后,运行显示的命令。

    带 ROCm

    要通过 pip 安装 PyTorch,并且您拥有 支持 ROCm 的 系统,请在上面的选择器中选择 OS: Linux, Package: Pip, Language: Python 和支持的 ROCm 版本。然后,运行显示的命令。

    验证

    为确保 PyTorch 安装正确,我们可以通过运行示例 PyTorch 代码来验证安装。这里我们将构建一个随机初始化的张量。

    import torch
    x = torch.rand(5, 3)
    print(x)
    

    输出应类似于

    tensor([[0.3380, 0.3845, 0.3217],
            [0.8337, 0.9050, 0.2650],
            [0.2979, 0.7141, 0.9069],
            [0.1449, 0.1132, 0.1375],
            [0.4675, 0.3947, 0.1426]])
    

    此外,要检查您的 GPU 驱动程序和 CUDA/ROCm 是否已启用并可由 PyTorch 访问,请运行以下命令以返回 GPU 驱动程序是否已启用(PyTorch 的 ROCm 版本在 Python API 级别使用相同的语义 链接,因此以下命令也应适用于 ROCm)

    import torch
    torch.cuda.is_available()
    

    从源代码构建

    对于大多数 PyTorch 用户来说,通过包管理器安装预构建的二进制文件将提供最佳体验。但是,有时您可能希望安装最新的 PyTorch 代码,无论是用于测试还是实际开发 PyTorch 核心。要安装最新的 PyTorch 代码,您需要 从源代码构建 PyTorch

    先决条件

    1. 安装 Pip
    2. 如果您需要使用 GPU 支持构建 PyTorch,a. 对于 NVIDIA GPU,请安装 CUDA,如果您的机器拥有 支持 CUDA 的 GPU。b. 对于 AMD GPU,请安装 ROCm,如果您的机器拥有 支持 ROCm 的 GPU
    3. 请遵循此处描述的步骤: https://github.com/pytorch/pytorch#from-source

    您可以按照 上方 的描述验证安装。

    在 Windows 上安装

    PyTorch 可以在各种 Windows 发行版上安装和使用。根据您的系统和计算需求,您在 Windows 上使用 PyTorch 的处理时间可能会有所不同。建议(但非必需)您的 Windows 系统拥有 NVIDIA GPU,以便充分利用 PyTorch 的 CUDA 支持

    先决条件

    支持的 Windows 发行版

    PyTorch 支持以下 Windows 发行版:

    此处提供的安装说明通常适用于所有支持的 Windows 发行版。所示的具体示例将在 Windows 10 Enterprise 机器上运行。

    Python

    目前,Windows 上的 PyTorch 仅支持 Python 3.10-3.14;不支持 Python 2.x。

    由于 Python 在 Windows 上不是默认安装的,有多种方法可以安装 Python:

    如果您决定使用 Chocolatey,并且尚未安装 Chocolatey,请确保以管理员身份运行命令提示符。

    对于基于 Chocolatey 的安装,请在管理员命令提示符中运行以下命令:

    choco install python
    

    包管理器

    要安装 PyTorch 二进制文件,您需要使用受支持的包管理器: pip

    pip

    如果您通过 上方 推荐的任何方式安装了 Python,则 pip 应该已经为您安装好了。

    安装

    pip

    无 CUDA

    要通过 pip 安装 PyTorch,并且您没有 支持 CUDA 的 系统或不需要 CUDA,请在上面的选择器中选择 OS: Windows, Package: Pip 和 CUDA: None。然后,运行显示的命令。

    带 CUDA

    要通过 pip 安装 PyTorch,并且您拥有 支持 CUDA 的 系统,请在上面的选择器中选择 OS: Windows, Package: Pip 和适合您机器的 CUDA 版本。通常,最新版本的 CUDA 更好。然后,运行显示的命令。

    验证

    为确保 PyTorch 安装正确,我们可以通过运行示例 PyTorch 代码来验证安装。这里我们将构建一个随机初始化的张量。

    从命令行,输入

    python
    

    然后输入以下代码

    import torch
    x = torch.rand(5, 3)
    print(x)
    

    输出应类似于

    tensor([[0.3380, 0.3845, 0.3217],
            [0.8337, 0.9050, 0.2650],
            [0.2979, 0.7141, 0.9069],
            [0.1449, 0.1132, 0.1375],
            [0.4675, 0.3947, 0.1426]])
    

    此外,要检查您的 GPU 驱动程序和 CUDA 是否已启用并可由 PyTorch 访问,请运行以下命令以返回 CUDA 驱动程序是否已启用

    import torch
    torch.cuda.is_available()
    

    从源代码构建

    对于大多数 PyTorch 用户来说,通过包管理器安装预构建的二进制文件将提供最佳体验。但是,有时您可能希望安装最新的 PyTorch 代码,无论是用于测试还是实际开发 PyTorch 核心。要安装最新的 PyTorch 代码,您需要 从源代码构建 PyTorch

    先决条件

    1. 安装 pip
    2. 安装 CUDA,如果您的机器拥有 支持 CUDA 的 GPU
    3. 如果您想在 Windows 上构建,还需要 Visual Studio 和 MSVC 工具集,以及 NVTX。这些依赖项的确切要求可以在 此处 找到。
    4. 请遵循此处描述的步骤: https://github.com/pytorch/pytorch#from-source

    您可以按照 上方 的描述验证安装。