安装 Anaconda Distribution#

在商业环境中使用 Anaconda？

您可能需要购买许可证以遵守我们的服务条款。

此页面提供在 Windows、macOS 和 Linux 上安装 Anaconda Distribution 的说明。

注意

如果您希望安装不包含 Anaconda Distribution 中包含的大量软件包的版本，请安装 Miniconda。

Miniconda 是 Anaconda Distribution 的免费迷你安装版本，仅包含 conda、Python、它们都依赖的软件包以及少量其他有用的软件包。

基本安装说明#

注意

如果您已安装多个版本的 Anaconda Distribution，只要您没有更改默认安装路径，系统默认使用最新版本。

Windows 安装

提示

更喜欢视觉学习？登录 Anaconda Cloud 并观看我们的 Anaconda 入门课程中的安装 Anaconda (Windows) 视频。此视频将在短短两分钟内指导您完成安装。

  1. 从 Anaconda 网站下载安装程序或使用您喜欢的命令行界面

    在anaconda.com/download上，注册 Anaconda 并单击Download。

    打开命令提示符窗口并运行以下命令

    curl https://repo.anaconda.com/archive/Anaconda3-2024.10-1-Windows-x86_64.exe --output .\Downloads\Anaconda3-2024.10-1-Windows-x86_64.exe
    要下载不同的版本

    在官方存档中查看 Anaconda Distribution 安装程序的完整列表。

    要下载不同版本的 Anaconda Distribution，请从存档中复制安装程序的 Filename，然后使用 curl 命令下载它

    # Replace <FILENAME> with the installer Filename you copied from the archive
curl https://repo.anaconda.com/archive/<FILENAME> --output <FILENAME>

    注意

    确保您下载的安装程序与您的操作系统兼容！

    打开 PowerShell 窗口并运行以下命令

    wget "https://repo.anaconda.com/archive/Anaconda3-2024.10-1-Windows-x86_64.exe" -outfile ".\Downloads\Anaconda3-2024.10-1-Windows-x86_64.exe"
    要下载不同的版本

    在官方存档中查看 Anaconda Distribution 安装程序的完整列表。

    要下载不同版本的 Anaconda Distribution，请从存档中复制安装程序的 Filename，然后使用 wget 命令下载它

    # Replace <FILENAME> with the installer Filename you copied from the archive
wget "https://repo.anaconda.com/archive/<FILENAME>"" -outfile ".\Downloads\<FILENAME>"

    注意

    确保您下载的安装程序与您的操作系统兼容！

  2. （推荐）验证安装程序的完整性，以确保它在下载过程中未被损坏或篡改。

    如何验证安装程序的完整性？

    为确保您下载的安装程序未被篡改或损坏，请生成其 SHA-256 哈希值，并将其与存档中提供的官方哈希值进行比较。

    1. 打开 PowerShell 并运行以下命令

      # Replace <INSTALLER_FILE> with the name of the downloaded installer file
Get-FileHash .\Downloads\<INSTALLER_FILE> -Algorithm SHA256

      例如

      Get-FileHash .\Downloads\Anaconda3-2024.10-1-Windows-x86_64.exe -Algorithm SHA256

    2. 记下输出中生成的 SHA-256 哈希值。

    3. 访问 repo.anaconda.com/archive 以查找安装程序的官方 SHA-256 哈希值。

    4. 比较哈希值。如果它们匹配，则安装程序可以安全使用。

    提示

    有关更多信息，请参阅官方 conda 文档中的加密哈希验证。

  3. 转到您的“下载”文件夹（或通过 CLI 下载的“主文件夹”），然后双击安装程序以启动。

    注意

    为防止权限错误，请勿从收藏夹文件夹启动安装程序。

    注意

    如果在安装过程中遇到问题，请在安装期间暂时禁用您的防病毒软件，然后在安装完成后重新启用它。如果您为所有用户安装，请卸载 Anaconda 并仅为仅我重新安装。

  4. 单击下一步，然后同意Anaconda 服务条款 (TOS)。

  5. 选择安装选项

    • 仅我（推荐）- 为当前用户帐户安装 Anaconda Distribution。

    • 所有用户 - 为计算机上的所有用户帐户安装 Anaconda Distribution（需要 Windows 管理员权限）。

  6. 单击下一步。

  7. 选择要安装 Anaconda 的目标文件夹，然后单击下一步。

    注意

    • 安装目录路径不能包含空格或 Unicode 字符。有关更多信息，请参阅FAQ。

    • 除非需要管理员权限，否则请勿以管理员身份安装。

  8. 自定义您的安装选项

    • 创建快捷方式 - 默认选中。为 Anaconda Navigator、Spyder、Jupyter Notebook 和 Anaconda Prompt 软件包创建“开始”菜单快捷方式。取消选择此选项将跳过创建这些快捷方式。

    • 将 Anaconda3 添加到我的 PATH 环境变量 - 将包含 conda 二进制文件的路径添加到您的 PATH 环境变量。

      Anaconda 不建议选择此选项。conda 二进制文件路径包含其他软件包二进制文件，即使当前没有激活任何 conda 环境，这些二进制文件也会永久添加到您的 PATH 环境变量中。这使其他软件可以使用这些软件包文件，这可能会导致错误。

      注意

      除非您计划安装和运行多个版本的 Anaconda Distribution 或 Python，否则请从“开始”菜单打开 Anaconda Navigator 或 Anaconda Prompt 以开始您的环境管理工作。

      注意

      从 Anaconda Distribution 2022.05 开始，在所有用户安装期间添加 Anaconda 到 PATH 环境变量的选项已被禁用。这样做是为了解决安全漏洞。您仍然可以在仅我安装期间将 Anaconda 添加到 PATH 环境变量。

    • 将 Anaconda3 注册为我的默认 Python 3.12 - 默认选中。将此安装中的 Python 软件包注册为 VSCode、PyCharm 等程序的默认 Python。

    • 完成后清除软件包缓存 - 在安装完成后运行 conda clean --all --force-pkgs-dirs。有关这些命令的更多信息，请参阅conda 命令文档。

  9. 单击安装。安装可能需要几分钟才能完成。单击显示详细信息以查看正在安装的软件包。

  10. 单击下一步两次，然后单击完成以关闭安装程序。

    提示

    如果您在公司代理后方，您可能需要进行一些额外的设置。有关更多信息，请参阅在公司代理后方使用 Anaconda。

macOS/Linux 安装

提示

更喜欢视觉学习？登录 Anaconda Cloud 并观看我们的 Anaconda 入门课程中的安装 Anaconda (Mac) 视频。此视频将在短短两分钟内指导您完成使用图形安装程序的过程。

注意

macOS 的图形安装程序将 Anaconda 安装到您文件系统中的 /opt/anaconda3 中。如果您想将 Anaconda 安装到您的主目录中，或者如果您在一个系统上有多个用户并且想要更仔细地管理您的安装，Anaconda 建议按照 macOS 命令行安装程序选项卡中的说明进行操作。

  1. 下载适用于您系统的图形 (.pkg) macOS 安装程序。

  2. （推荐）验证安装程序的完整性，以确保它在下载过程中未被损坏或篡改。

    如何验证安装程序的完整性？

    为确保您下载的安装程序未被篡改或损坏，请生成其 SHA-256 哈希值，并将其与存档中提供的官方哈希值进行比较。

    1. 打开终端并运行以下命令

      # Replace <INSTALLER-FILE> with the name of the downloaded installer file
shasum -a 256 ~/Downloads/<INSTALLER-FILE>

      例如

      shasum -a 256 ~/Downloads/Anaconda3-2024.10-1-MacOSX-x86_64.pkg

    2. 记下输出中生成的 SHA-256 哈希值。

    3. 访问 repo.anaconda.com/archive 以查找安装程序的官方 SHA-256 哈希值。

    4. 比较哈希值。如果它们匹配，则安装程序可以安全使用。

    提示

    有关更多信息，请参阅官方 conda 文档中的加密哈希验证。

  3. 双击下载的文件，然后单击继续以开始安装。

  4. 查看“自述文件”说明，然后单击继续。

  5. 阅读Anaconda 服务条款 (TOS)，然后单击继续，再单击同意以同意这些条款。

    注意

    对于 2023.09 或更早版本的安装程序，安装程序可能会在安装过程中跳过“选择目标位置”页面，这将导致安装失败。如果安装程序跳过此页面，请单击“安装类型”页面上的更改安装位置…以进入此步骤。

  6. 选择安装位置

    • 为这台计算机的所有用户安装（推荐）- 将 Anaconda Distribution 安装到 /opt/anaconda3 中，供计算机的所有用户使用。

    • 安装在特定磁盘上 - 使您能够选择不同的位置来安装 Anaconda Distribution。

    注意

    如果您收到错误消息“您无法在此位置安装 Anaconda”，请重新选择为这台计算机的所有用户安装，然后重试。

  7. 单击安装。安装可能需要几分钟才能完成。

    注意

    如果您收到错误消息“此软件包与此 macOS 版本不兼容”，请参阅此处以获得故障排除帮助。

  8. 单击继续。

  9. 单击关闭以退出安装程序。

  1. 通过打开终端并运行以下命令之一（取决于您的 macOS 架构）来下载安装程序

    curl -O https://repo.anaconda.com/archive/Anaconda3-2024.10-1-MacOSX-arm64.sh
    curl -O https://repo.anaconda.com/archive/Anaconda3-2024.10-1-MacOSX-x86_64.sh
    要下载不同的版本

    在官方存档中查看 Anaconda Distribution 安装程序的完整列表。

    要下载不同版本的 Anaconda Distribution，请从存档中复制安装程序的 Filename，然后使用 curl 命令下载它

    # Replace <FILENAME> with the installer Filename you copied from the archive
curl https://repo.anaconda.com/archive/<FILENAME> --output <FILENAME>

    注意

    确保您下载的安装程序与您的操作系统兼容！

  2. （推荐）验证安装程序的完整性，以确保它在下载过程中未被损坏或篡改。

    如何验证安装程序的完整性？

    为确保您下载的安装程序未被篡改或损坏，请生成其 SHA-256 哈希值，并将其与存档中提供的官方哈希值进行比较。

    1. 打开终端并运行以下命令

      # Replace <INSTALLER-FILENAME> with the name of the downloaded installer file
shasum -a 256 ~/<INSTALLER-FILENAME>

      例如

      shasum -a 256 ~/Anaconda3-2024.10-1-MacOSX-arm64.sh

    2. 记下输出中生成的 SHA-256 哈希值。

    3. 访问 repo.anaconda.com/archive 以查找安装程序的官方 SHA-256 哈希值。

    4. 比较哈希值。如果它们匹配，则安装程序可以安全使用。

    提示

    有关更多信息，请参阅官方 conda 文档中的加密哈希验证。

  3. 通过运行以下命令进行安装（取决于您的 macOS 架构）

    bash ~/Anaconda3-2024.10-1-MacOSX-arm64.sh
    bash ~/Anaconda3-2024.10-1-MacOSX-x86_64.sh

  4. 按 Return 键查看 Anaconda 服务条款 (TOS)。然后按住 Return 键滚动。

  5. 输入 yes 以同意 TOS。

  6. 按 Return 键接受默认安装位置 (PREFIX=/Users/<USER>/anaconda3)，或输入另一个文件路径以指定备用安装目录。安装可能需要几分钟才能完成。

  7. 选择初始化选项

    • 是 - conda 修改您的 shell 配置，以便在您每次打开新 shell 时初始化 conda 并自动识别 conda 命令。

    • 否 - conda 不会修改您的 shell 脚本。安装后，如果您想初始化，则必须手动执行。有关更多信息，请参阅手动 shell 初始化。

  8. 安装程序完成并显示“感谢您安装 Anaconda3！”

  9. 关闭并重新打开终端窗口以使安装完全生效，或使用以下命令刷新终端

    source ~/.zshrc
手动 shell 初始化

安装成功完成后，通过运行以下命令初始化您的 shell

# Replace <PATH_TO_CONDA> with the path to your conda install
source <PATH_TO_CONDA>/bin/activate
conda init --all

如果您想指定要初始化的 shell，请参阅官方 conda 文档中的 conda init，以获取受支持 shell 的列表。

注意

macOS 10.15 及更高版本使用 zsh 作为默认 shell。安装过程完成后，通过运行以下命令在 zsh shell 中初始化 conda

source <PATH_TO_CONDA>/bin/activate
conda init zsh

注意

您还可以控制每次打开 shell 时是否激活基本环境。以下命令仅在 conda 首次初始化后才有效

conda config --set auto_activate_base True

conda config --set auto_activate_base False

  1. 通过打开终端并运行以下命令之一（取决于您的 Linux 架构）来下载最新版本的 Anaconda Distribution

    wget https://repo.anaconda.com/archive/Anaconda3-2024.10-1-Linux-x86_64.sh
    wget https://repo.anaconda.com/archive/Anaconda3-2024.10-1-Linux-aarch64.sh

    • linux-aarch64 软件包构建可能与某些 Raspberry Pi 设置不兼容，因为 Anaconda 使用针对服务器级 Neoverse N1/N2 微架构的编译器选项。

    wget https://repo.anaconda.com/archive/Anaconda3-2024.10-1-Linux-s390x.sh
    要下载不同的版本

    在官方存档中查看 Anaconda Distribution 安装程序的完整列表。

    要下载不同版本的 Anaconda Distribution，请从存档中复制安装程序的 Filename，然后使用 wget 命令下载它

    # Replace <FILENAME> with the installer Filename you copied from the archive
wget https://repo.anaconda.com/archive/<FILENAME>

    注意

    确保您下载的安装程序与您的操作系统兼容！

  2. （推荐）验证安装程序的完整性，以确保它在下载过程中未被损坏或篡改。

    如何验证安装程序的完整性？

    为确保您下载的安装程序未被篡改或损坏，请生成其 SHA-256 哈希值，并将其与存档中提供的官方哈希值进行比较。

    1. 打开终端并运行以下命令

      # Replace <INSTALLER-FILENAME> with the name of the downloaded installer file
shasum -a 256 ~/<INSTALLER-FILENAME>

      例如

      shasum -a 256 ~/Anaconda3-2024.10-1-Linux-x86_64.sh

    2. 记下输出中生成的 SHA-256 哈希值。

    3. 访问 repo.anaconda.com/archive 以查找安装程序的官方 SHA-256 哈希值。

    4. 比较哈希值。如果它们匹配，则安装程序可以安全使用。

    提示

    有关更多信息，请参阅官方 conda 文档中的加密哈希验证。

  3. 通过运行以下命令之一安装 Anaconda Distribution（取决于您的 Linux 架构）

    bash ~/Anaconda3-2024.10-1-Linux-x86_64.sh
    bash ~/Anaconda3-2024.10-1-Linux-aarch64.sh
    bash ~/Anaconda3-2024.10-1-Linux-s390x.sh

  4. 按 Return 键查看 Anaconda 服务条款 (TOS)。然后按住 Return 键滚动。

  5. 输入 yes 以同意 TOS。

  6. 按 Return 键接受默认安装位置 (PREFIX=/Users/<USER>/anaconda3)，或输入另一个文件路径以指定备用安装目录。安装可能需要几分钟才能完成。

  7. 选择初始化选项

    • 是 - conda 修改您的 shell 配置，以便在您每次打开新 shell 时初始化 conda 并自动识别 conda 命令。

    • 否 - conda 不会修改您的 shell 脚本。安装后，如果您想初始化，则必须手动执行。有关更多信息，请参阅手动 shell 初始化。

  8. 安装程序完成并显示“感谢您安装 Anaconda3！”

  9. 关闭并重新打开终端窗口以使安装完全生效，或使用以下命令刷新终端，具体取决于您的 shell

    source ~/.bashrc

    source ~/.zshrc

    exec fish
手动 shell 初始化

安装成功完成后，通过运行以下命令初始化您的 shell

# Replace <PATH_TO_CONDA> with the path to your conda install
source <PATH_TO_CONDA>/bin/activate
conda init --all

如果您想指定要初始化的 shell，请参阅官方 conda 文档中的 conda init，以获取受支持 shell 的列表。

Navigator 依赖项

Anaconda Navigator 默认包含在 Anaconda Distribution 中。但是，某些版本的 Anaconda Distribution 可能需要以下扩展依赖项，才能在 Linux 中使用 Anaconda Navigator（和其他 GUI 软件包）

apt-get install libgl1-mesa-glx libegl1-mesa libxrandr2 libxrandr2 libxss1 libxcursor1 libxcomposite1 libasound2 libxi6 libxtst6

yum install libXcomposite libXcursor libXi libXtst libXrandr alsa-lib mesa-libEGL libXdamage mesa-libGL libXScrnSaver

pacman -Sy libxau libxi libxss libxtst libxcursor libxcomposite libxdamage libxfixes libxrandr libxrender mesa-libgl alsa-lib libglvnd

zypper install libXcomposite1 libXi6 libXext6 libXau6 libX11-6 libXrandr2 libXrender1 libXss1 libXtst6 libXdamage1 libXcursor1 libxcb1 libasound2 libX11-xcb1 Mesa-libGL1 Mesa-libEGL1

emerge x11-libs/libXau x11-libs/libxcb x11-libs/libX11 x11-libs/libXext x11-libs/libXfixes x11-libs/libXrender x11-libs/libXi x11-libs/libXcomposite x11-libs/libXrandr x11-libs/libXcursor x11-libs/libXdamage x11-libs/libXScrnSaver x11-libs/libXtst media-libs/alsa-lib media-libs/mesa

注意

您还可以控制每次打开 shell 时是否激活基本环境。以下命令仅在 conda 首次初始化后才有效

conda config --set auto_activate_base True

conda config --set auto_activate_base False
验证您的安装

Anaconda Navigator，conda 的图形用户界面 (GUI)，应在 Anaconda Distribution 成功安装后自动打开。

如果它没有打开，请通过手动打开应用程序或使用 CLI 来验证您的安装

  1. 在任务栏搜索中搜索“Anaconda Navigator”。

  2. 选择Anaconda Navigator。

  1. 单击启动台。

  2. 选择Anaconda Navigator。

您也可以使用 Cmd+空格键打开 Spotlight 搜索并搜索 Navigator。

  1. 在大多数 Linux 发行版中，使用 Ctrl+Alt+T 打开终端应用程序。

  2. 通过运行以下命令打开 Navigator

    anaconda-navigator

如果 Navigator 未打开，请查看我们的帮助资源。

  1. 访问您操作系统的 CLI

    1. 在任务栏搜索中搜索“Anaconda Prompt”。

    2. 选择Anaconda Prompt。

    1. 使用 Cmd+空格键打开 Spotlight 搜索。

    2. 键入“终端”并按 Return 键打开。

    在大多数 Linux 发行版中，使用 Ctrl+Alt+T 打开终端应用程序。

    您应该在命令行提示符中看到 (base)。这告诉您您位于基本 conda 环境中。要了解有关环境的更多信息，请参阅环境。

  2. 运行任何 conda 命令。例如

    • conda list - 显示已安装在您的活动环境中的软件包列表及其版本。

    • anaconda-navigator - 打开 Anaconda Navigator。

高级安装选项#

有关更高级的安装说明，例如使用静默模式安装、在旧操作系统上安装或多用户安装，请参阅高级安装。

获取 Anaconda 或 Miniconda 的其他方法#

有关使用 Anaconda Docker 镜像或 Anaconda Cloudera Distributed Hadoop 集群的说明，请参阅应用程序/集成。

问题？#

下一步是什么？#

在Anaconda 入门指南中开始使用 Anaconda 进行编程。

访问 Anaconda Cloud 以在 notebook 中开始免费编程。也可从Anaconda Learning 学习如何操作！

在本页中