安装 Anaconda 发行版#

在商业环境中使用 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，请从存档中复制安装程序的文件名，然后使用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，请从存档中复制安装程序的文件名，然后使用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. 转到 Downloads 文件夹（如果通过 CLI 下载，则转到 Home 文件夹），然后双击安装程序以启动。

    谨慎

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

    注意

    如果您在安装过程中遇到问题，请在安装过程中暂时禁用防病毒软件，然后在安装结束后重新启用它。如果您为所有用户安装了，请卸载 Anaconda 并仅为 Just Me 重新安装它。

  4. 单击下一步，然后同意 Anaconda 的服务条款 （TOS）。

  5. 选择安装选项：

    • Just Me （recommended） - 为当前用户帐户安装 Anaconda Distribution。

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

  6. 单击 Next。

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

    谨慎

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

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

  8. 自定义您的安装选项：

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

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

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

      注意

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

      谨慎

      截至Anaconda Distribution 2022.05，则在“所有用户”安装期间将 Anaconda 添加到 PATH 环境变量的选项已被禁用。这样做是为了解决安全漏洞。您仍然可以在 Just Me 安装期间将 Anaconda 添加到 PATH 环境变量中。

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

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

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

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

    提示

    如果您支持公司代理，则可能需要进行一些额外的设置。有关更多信息，请参阅在公司代理后面使用 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. 双击下载的文件，然后单击 Continue 开始安装。

  4. 查看 Read Me 说明，然后单击 Continue （继续）。

  5. 通读 Anaconda 的服务条款 （TOS） 并单击 继续，然后单击 同意 同意这些条款。

    谨慎

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

  6. 选择安装位置：

    • 为此计算机的所有用户安装 （推荐） - 将 Anaconda 发行版安装到/opt/anaconda3适用于计算机的所有用户。

    • Install on a specific disk （在特定磁盘上安装） - 使您能够选择其他位置来安装 Anaconda Distribution。

    谨慎

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

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

    注意

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

  8. 单击 Continue（继续）。

  9. 单击 Close 退出安装程序。

  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，请从存档中复制安装程序的文件名，然后使用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. 按返回键查看 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。安装过程完成后，在zshshell 来运行以下命令：

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，请从存档中复制安装程序的文件名，然后使用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. 按返回键查看 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. 单击 Launchpad 。

  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 分布式 Hadoop 集群的说明，请参阅应用程序/集成。

问题？#

下一步是什么？#

Anaconda 入门指南中的开始使用 Anaconda 编程。

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

本页内容