Conda 入门#

Conda 是一个强大的命令行工具,用于包和环境管理,可在 Windows、macOS 和 Linux 上运行。

本 conda 入门指南介绍了启动和使用 conda 创建环境和安装包的基础知识。

提示

Anaconda Navigator 是一个图形桌面应用程序,使您无需在命令行运行命令即可使用 conda。

请参阅Anaconda Navigator 入门以了解更多信息。

开始之前#

要引导 conda 安装,请使用最小安装程序,例如 MinicondaMiniforge

Conda 也包含在 Anaconda Distribution 中。

注意

Miniconda 和 Anaconda Distribution 预配置为使用 Anaconda Repository,并且从该仓库安装/使用软件包受 Anaconda 服务条款的约束,这意味着它可能需要商业付费许可证。 个人、大学和员工人数少于 200 人的公司(截至 2024 年 9 月)有例外情况。

请查看服务条款、Anaconda 最新的Anaconda 学术和研究服务条款更新以及Anaconda 服务条款常见问题解答来解答您的问题。

启动 conda#

Conda 在 Windows、macOS 或 Linux 上可用,可以与任何终端应用程序(或 shell)一起使用。

  1. 打开命令提示符 (cmd.exe) 或 PowerShell。

  1. 打开 Launchpad。

  2. 打开“其他”应用程序文件夹。

  3. 打开“终端”应用程序。

打开终端窗口。

创建环境#

Conda 允许您创建独立的环境,每个环境都包含自己的文件、包和包依赖项。 每个环境的内容互不干扰。

创建新环境最基本的方法是使用以下命令

conda create -n <env-name>

要在创建环境时添加包,请在环境名称后指定它们

conda create -n myenvironment python numpy pandas

有关使用环境的更多信息,请参阅管理环境

列出环境#

要查看所有环境的列表

conda info --envs

将显示环境列表,类似于以下内容

conda environments:

   base           /home/username/Anaconda3
   myenvironment   * /home/username/Anaconda3/envs/myenvironment

提示

活动环境是用星号 (*) 标记的环境。

要将当前环境更改回默认 base

conda activate

提示

当环境被停用时,其名称不再显示在提示符中,星号 (*) 返回到 base。 要验证,您可以重复 conda info --envs 命令。

安装包#

您还可以将包安装到先前创建的环境中。 为此,您可以激活要修改的环境,或在命令行上指定环境名称

# via environment activation
conda activate myenvironment
conda install matplotlib

# via command line option
conda install --name myenvironment matplotlib

有关搜索和安装包的更多信息,请参阅管理包

指定通道#

通道是存储包的位置(在您自己的计算机上或 Internet 上的其他位置)。 默认情况下,conda 在其默认通道中搜索包。

如果您想要的包位于另一个通道中,例如 conda-forge,您可以在安装包时手动指定通道

conda install conda-forge::numpy

您还可以在 .condarc 文件中覆盖默认通道。 有关直接示例,请参阅通道位置(channels)或阅读完整的使用 .condarc conda 配置文件

提示

通过搜索 Anaconda.org 查找更多包和通道。

更新 conda#

要查看您的 conda 版本,请使用以下命令

conda --version

无论您在哪个环境中运行此命令,conda 都会显示其当前版本

conda 25.1.1

注意

如果您收到错误消息 command not found: conda,请关闭并重新打开终端窗口,并验证您是否已登录到用于安装 conda 的同一用户帐户。

要将 conda 更新到最新版本

conda update conda

Conda 会将您的版本与最新的可用版本进行比较,然后显示可安装的内容。

提示

我们建议您始终将 conda 更新到最新版本。 有关 conda 的官方版本支持策略,请参阅 CEP 10

更多信息#