安装 Miniconda#

本页包含适用于 Windows、macOS 和 Linux 的基本 Miniconda 安装说明，以及命令行快速入门安装指南。

注意

在 Windows、macOS 和 Linux 上，最好为本地用户安装 Miniconda，它不需要管理员权限，是最强大的安装类型。但是，如果需要，您可以在系统范围内安装 Miniconda，这确实需要管理员权限。

基本安装说明#

Windows 安装

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

    导航到 anaconda.com/download，向 Anaconda 注册（如果需要），向下滚动经过 Anaconda Distribution 安装程序，然后选择 64 位 Windows Miniconda 安装程序。

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

    curl https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe --output .\Downloads\Miniconda3-latest-Windows-x86_64.exe
    下载其他版本

    在官方 Miniconda 档案中查看 Miniconda 安装程序的完整列表。

    要下载不同版本的 Miniconda，请从 Miniconda 存档中复制安装程序的文件名，然后使用curl命令：

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

    谨慎

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

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

    wget "https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe" -outfile ".\Downloads\Miniconda3-latest-Windows-x86_64.exe"
    下载其他版本

    在官方 Miniconda 档案中查看 Miniconda 安装程序的完整列表。

    要下载不同版本的 Miniconda，请从 Miniconda 存档中复制安装程序的文件名，然后使用wget命令：

    # Replace <FILENAME> with the installer Filename you copied from the Miniconda archive
wget "https://repo.anaconda.com/miniconda/<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\Miniconda3-latest-Windows-x86_64.exe -Algorithm SHA256

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

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

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

    提示

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

  3. 转到 Downloads 文件夹（如果通过 CLI 下载，则转到 Home 文件夹），然后双击安装程序以启动。

    谨慎

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

    注意

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

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

  5. 选择安装选项：

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

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

  6. 单击 Next。

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

    谨慎

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

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

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

    • 创建快捷方式 - 默认选中。为 Anaconda Prompt 包创建 Start Menu 快捷方式。取消选择此选项将跳过创建这些快捷键。

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

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

      注意

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

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

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

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

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

有关以静默模式安装的信息，请参阅 conda 项目文档中的快速命令行安装命令（示例）或在 Windows 上安装的以静默模式安装部分。

macOS/Linux 安装

谨慎

MacOS图形安装程序将 Miniconda 安装到/opt/miniconda3在您的文件系统中。如果您想将 Miniconda 安装到您的主目录中，或者您的系统上有多个用户并希望更仔细地管理您的安装，Anaconda 建议使用 shell（或命令行）安装程序。

  1. 下载 .pkg 安装程序。Miniconda 是 Distribution 安装程序的较小版本，现在可通过 Anaconda 网站获得。

  2. （可选）Anaconda 建议在下载安装程序后验证安装程序的完整性。

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

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

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

      # Replace <FILE_NAME> with the path to your installer
shasum -a 256 <FILE_NAME>

      例如：

      shasum -a 256 ~/Downloads/Miniconda3-latest-MacOSX-arm64.pkg

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

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

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

    提示

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

  3. 双击.pkg文件。

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

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

  6. 选择安装位置：

    • 为此计算机的所有用户安装 （推荐） - 将 Miniconda 安装到计算机的所有用户的 /opt/miniconda3 中。

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

  7. 单击 Install。安装完成后，打开您的终端应用程序。

    注意

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

  8. 通过运行conda list.如果 conda 已正确安装，则会显示已安装包的列表。

  1. 下载.sh安装程序：

    curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-arm64.sh

    curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh
    下载其他版本

    在官方 Miniconda 档案中查看 Miniconda 安装程序的完整列表。

    要下载不同版本的 Miniconda，请从存档中复制安装程序的文件名，然后使用curl命令：

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

    谨慎

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

  2. （可选）Anaconda 建议在下载安装程序后验证安装程序的完整性。

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

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

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

      # Replace <FILE_NAME> with the path to your installer
shasum -a 256 <FILE_NAME>

      例如：

      shasum -a 256 ~/Downloads/Miniconda3-latest-MacOSX-arm64.sh

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

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

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

    提示

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

  3. 通过运行以下命令进行安装（具体取决于您的 macOS 体系结构）：

    bash ~/Miniconda3-latest-MacOSX-arm64.sh

    bash ~/Miniconda3-latest-MacOSX-x86_64.sh

  4. 按返回键查看 Anaconda 的服务条款 （TOS）。然后按住 Return 键滚动。

  5. 进入yes同意 TOS。

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

  7. 选择初始化选项：

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

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

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

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

    source ~/.zshrc

    注意

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

  10. 通过运行conda list.如果 conda 已正确安装，则会显示已安装包的列表。

手动 shell 初始化

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

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

注意

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

source <PATH_TO_CONDA>/bin/activate
conda init zsh

有关以静默模式安装的信息，请参阅 conda 项目文档中的快速命令行安装命令以获取示例或在 macOS 上安装的以静默模式安装部分。

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

    wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh

    wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-aarch64.sh

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

    wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-s390x.sh
    下载其他版本

    在官方 Miniconda 档案中查看 Miniconda 安装程序的完整列表。

    要下载不同版本的 Miniconda，请从存档中复制安装程序的文件名，然后使用wget命令：

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

    谨慎

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

  2. （可选）Anaconda 建议在下载安装程序后验证安装程序的完整性。

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

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

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

      # Replace <FILE_NAME> with the path to your installer
sha256sum <FILE_NAME>

      例如：

      sha256sum ~/Downloads/Miniconda3-latest-Linux-x86_64.sh

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

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

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

    提示

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

  3. 通过运行以下命令之一安装 Miniconda（具体取决于您的 Linux 体系结构）：

    bash ~/Miniconda3-latest-Linux-x86_64.sh

    bash ~/Miniconda3-latest-Linux-aarch64.sh

    bash ~/Miniconda3-latest-Linux-s390x.sh

  4. 按返回键查看 Anaconda 的服务条款 （TOS）。然后按住 Return 键滚动。

  5. 进入yes同意 TOS。

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

  7. 选择初始化选项：

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

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

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

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

    source ~/.bashrc

    source ~/.zshrc

    exec fish

    注意

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

  10. 通过运行conda list.如果 conda 已正确安装，则会显示已安装包的列表。

手动 shell 初始化

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

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

注意

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

source <PATH_TO_CONDA>/bin/activate
conda init zsh

有关以静默模式安装的信息，请参阅 conda 项目文档中的快速命令行安装命令以获取示例或在 macOS 上安装的以静默模式安装部分。

验证安装

使用 CLI 验证 Miniconda 的安装：

  1. 访问作系统的 CLI：

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

    2. 选择 Anaconda Prompt。

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

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

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

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

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

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

    • conda --version-显示conda的版本号。

快速入门安装说明#

这些命令行说明将帮助您使用最新的 Miniconda 安装程序快速设置。按照系统的步骤下载并安装 Miniconda，然后按照上面验证您的安装中的步骤验证您的 Miniconda 安装。

谨慎

这些快速安装命令运行静默安装。如果您运行静默安装，则默认接受 Anaconda 的服务条款 （TOS）。在继续静默安装之前，请务必在此处查看 Anaconda 的完整 TOS。

这三个命令可以快速、安静地下载最新的 64 位 Windows 安装程序，将其重命名为较短的文件名，执行静默安装，然后删除安装程序：

curl https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -o .\miniconda.exe
start /wait "" .\miniconda.exe /S
del .\miniconda.exe
下载旧版本

您可以在 https://repo.anaconda.com/miniconda 上找到旧版本的 Windows 安装程序。

例如，要为 64 位 Windows 计算机下载适用于 Python 3.12 的旧版本 Miniconda，请将curl命令替换为以下内容curl命令：

curl https://repo.anaconda.com/miniconda/Miniconda3-py312_24.5.0-0-Windows-x86_64.exe -o .\miniconda.exe

安装完成后，打开“Anaconda Prompt （miniconda3）”程序以使用 Miniconda3。

这三个命令可以快速、安静地下载最新的 64 位 Windows 安装程序，将其重命名为较短的文件名，执行静默安装，然后删除安装程序：

wget "https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe" -outfile ".\miniconda.exe"
Start-Process -FilePath ".\miniconda.exe" -ArgumentList "/S" -Wait
del .\miniconda.exe
下载旧版本

您可以在 https://repo.anaconda.com/miniconda/ 中找到旧版本的 Windows 安装程序。

例如，要为 64 位 Windows 计算机下载适用于 Python 3.12 的旧版本 Miniconda，请将wget命令替换为以下内容wget命令：

wget "https://repo.anaconda.com/miniconda/Miniconda3-py312_24.5.0-0-Windows-x86_64.exe" -outfile ".\miniconda.exe"

安装后，打开“Anaconda Powershell Prompt （miniconda3）”。

  1. 运行以下四个命令，下载并安装适用于所选芯片架构的最新 macOS 安装程序。这些命令逐行运行：

    • 在您的主目录中创建一个名为 “miniconda3” 的新目录。

    • 下载所选芯片架构的 macOS Miniconda 安装脚本，并将脚本另存为miniconda.sh在 miniconda3 目录中。

    • 运行miniconda.sh使用 bash 的静默模式下的安装脚本。

    • 删除miniconda.sh安装完成后的安装脚本文件。

    mkdir -p ~/miniconda3
curl https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-arm64.sh -o ~/miniconda3/miniconda.sh
bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3
rm ~/miniconda3/miniconda.sh

    mkdir -p ~/miniconda3
curl https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda3/miniconda.sh
bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3
rm ~/miniconda3/miniconda.sh
    下载旧版本

    您可以在 https://repo.anaconda.com/miniconda 上找到不同版本的 macOS 安装程序。

    例如，要为 M1 macOS 计算机下载旧版本的 Miniconda for Python 3.12，请将curl命令替换为以下内容curl命令：

    curl https://repo.anaconda.com/miniconda/Miniconda3-py312_24.5.0-0-MacOSX-arm64.sh -o ~/miniconda3/miniconda.sh

    或者，要为 Intel 芯片 macOS 计算机下载适用于 Python 3.9 的旧版本 Miniconda，请将curl命令替换为以下内容curl命令：

    mkdir -p ~/miniconda3
curl https://repo.anaconda.com/miniconda/Miniconda3-py39_24.5.0-0-MacOSX-x86_64.sh -o ~/miniconda3/miniconda.sh

  2. 安装后，关闭并重新打开您的终端应用程序，或通过运行以下命令刷新它：

    source ~/miniconda3/bin/activate

  3. 然后，通过运行以下命令在所有可用的 shell 上初始化 conda：

    conda init --all

如果您在安装后未初始化 conda，则即使已安装 conda，也可能会看到“conda not found”错误。有关可能的解决方案，请参阅 Conda： 在 macOS/Linux 上找不到命令疑难解答主题。

  1. 运行以下四个命令，下载并安装适用于所选芯片架构的最新 Linux 安装程序。这些命令逐行运行：

    • 在您的主目录中创建一个名为 “miniconda3” 的新目录。

    • 下载适用于所选芯片架构的 Linux Miniconda 安装脚本，并将脚本另存为miniconda.sh在 miniconda3 目录中。

    • 运行miniconda.sh使用 bash 的静默模式下的安装脚本。

    • 删除miniconda.sh安装完成后的安装脚本文件。

    mkdir -p ~/miniconda3
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda3/miniconda.sh
bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3
rm ~/miniconda3/miniconda.sh

    mkdir -p ~/miniconda3
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-aarch64.sh -O ~/miniconda3/miniconda.sh
bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3
rm ~/miniconda3/miniconda.sh

    mkdir -p ~/miniconda3
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-s390x.sh -O ~/miniconda3/miniconda.sh
bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3
rm ~/miniconda3/miniconda.sh
    下载旧版本

    您可以在 https://repo.anaconda.com/miniconda 上找到不同版本的 macOS 安装程序。

    例如，要为 64 位版本的 Linux 下载适用于 Python 3.12 的旧版本 Miniconda，请将wget命令替换为以下内容wget命令：

    wget https://repo.anaconda.com/miniconda/Miniconda3-py312_24.5.0-0-Linux-x86_64.sh -O ~/miniconda3/miniconda.sh

  2. 安装后，关闭并重新打开您的终端应用程序，或通过运行以下命令刷新它：

    source ~/miniconda3/bin/activate

  3. 然后，通过运行以下命令在所有可用的 shell 上初始化 conda：

    conda init --all

如果您在安装后未初始化 conda，则即使已安装 conda，也可能会看到“conda not found”错误。有关可能的解决方案，请参阅 Conda： 在 macOS/Linux 上找不到命令疑难解答主题。

本页内容