快速入门指南#

本快速入门指南旨在帮助您创建Anaconda账户，获取conda软件，并配置它以访问您的Anaconda实例。

创建账户#

前往 https://anaconda.cloud/sign-up.

从这里开始，您有几个账户注册的选项：

  • 使用电子邮件和密码手动注册

  • 使用GitHub、Gmail或Microsoft账户进行身份验证

手动注册#

  1. 点击使用电子邮件注册。

  2. 输入您的姓名、电子邮件地址和密码。

  3. 检查您的电子邮件以获取验证邮件。

  4. 点击电子邮件中的验证链接以完成账户验证。

订阅Anaconda#

有关管理订阅的信息和帮助，请参阅Subscriptions。

安装conda软件#

如果您已经安装了Anaconda Distribution或Miniconda，您已经准备好继续前进了！

如果您尚未安装Anaconda Distribution或Miniconda，请下载Anaconda Distribution或Miniconda并在继续配置之前将其安装在您的系统上。

仍然不确定选择什么？请参考我们的Anaconda Distribution vs Miniconda主题以获取指导。

如果您选择下载Miniconda，则需要单独安装Anaconda Navigator。

  1. 在Windows搜索框中输入“Anaconda Prompt”，然后打开Miniconda命令提示符。

  2. 通过运行以下命令安装Anaconda Navigator：

    conda install anaconda-navigator

如果您选择下载Miniconda，您需要单独安装Anaconda Navigator。要使用Miniconda安装Anaconda Navigator：

  1. 打开一个终端。

  2. 通过运行以下命令安装Anaconda Navigator：

conda install anaconda-navigator

安装Anaconda Distribution或Miniconda后，您可以使用它来安装conda-token包！

  1. 打开一个终端。你应该会看到命令行前面有(base)。这意味着你处于你的基础conda环境中。

  2. 通过运行以下命令安装 conda-token：

    conda install conda-token --name base

  3. 当提示时输入“y”以继续安装。

认证到Anaconda#

Anaconda 使用私人令牌来验证用户对其组织的身份。您必须被分配到一个组织中的席位才能激活令牌。一旦您被分配了席位，您可以随时为自己生成一个私人令牌。

  1. 转到您组织的页面。

  2. 从左侧导航中选择 Token Access。

  3. 如果是第一次接收令牌，请选择激活令牌，如果是获取新令牌，请选择重新发放令牌。一封包含私密令牌的自动邮件将发送到与您的Anaconda账户关联的地址。

  4. 复制您在电子邮件中收到的私人令牌，并在Navigator或CLI中设置它：

    1. 启动Anaconda Navigator。

    2. 选择连接，然后登录到Anaconda Professional。

      注意

      Pro（旧版）和Business层级共享一个精选包的存储库。因此，只要您拥有正确的访问令牌，登录Anaconda Professional即可访问您所需的Package Security Manager通道。

    3. 粘贴令牌，然后点击设置令牌。

    通过运行以下命令配置conda以使用此令牌：

    # Replace <TOKEN> with the token you received in your email
conda token set <TOKEN>

    注意

    每次收到新令牌时，您都必须运行此命令。

    以下是正确设置令牌时终端将显示的示例：

关于.condarc文件的重要信息#

.condarc 文件是一个配置文件，它告诉 conda 在哪里查找包。以下是一个 .condarc 文件的示例：

channels:
  - https://repo.anaconda.cloud/repo/<ORG_ID>/<CHANNEL_NAME> # Business tier only
  - defaults
add_anaconda_token: true
restore_free_channel: false
default_channels:
  - https://repo.anaconda.cloud/repo/main
  - https://repo.anaconda.cloud/repo/r
  - https://repo.anaconda.cloud/repo/msys2

Conda首先在channels:列表顶部的频道中搜索请求的包。如果该频道包含请求的包，则从该频道下载。

如果请求的包不在该通道中，conda 将在 channels: 列表的下一个条目中搜索该包。

当 conda 到达 channels: 列表中的 defaults 条目时，它会按照相同的降序搜索 default_channels: 下列出的通道。

在这个业务层的示例中，conda 将首先在您组织的频道中查找请求的包，然后按照列出的顺序在默认频道中查找，从 https://repo.anaconda.cloud/repo/main 开始，然后是 https://repo.anaconda.cloud/repo/r，最后在 https://repo.anaconda.cloud/repo/msys2（仅限 Windows）中查找。

对于Pro tier (legacy)，conda 将按照列出的顺序在默认通道中查找，首先是 https://repo.anaconda.cloud/repo/main，然后是 https://repo.anaconda.cloud/repo/r，最后是 https://repo.anaconda.cloud/repo/msys2（仅限 Windows）。

有关.condarc文件的更多信息，请参阅官方的conda文档。

查看你的 .condarc 文件#

您可以在Navigator或CLI中查看和编辑您的.condarc文件：

在Anaconda Navigator中，从菜单栏导航到首选项并选择配置Conda。

注意

你可以直接从该视图中编辑.condarc文件。

在终端中运行以下命令：

cat .condarc

将组织频道添加到您的 .condarc 文件#

注意

本节仅适用于商业层级。

  1. 转到您组织的页面。

  2. 选择您的组织。

  3. 从左侧导航中选择频道。

  4. 选择复制通道路径 图标。

  5. 打开你的终端并运行以下命令：

    # Replace <CHANNEL_PATH> with the copied channel path
conda config --prepend channels <CHANNEL_PATH>

将conda-forge添加为频道#

如果您需要从conda-forge仓库安装包，您可以在Navigator或CLI中进行操作：

  1. 选择频道，然后点击添加…。

  2. 输入 conda-forge 作为您的频道。

  3. 按 Enter（Windows）/Return（Mac）添加频道。

  4. 点击更新频道以指示导航器更新channels:列表在你的.condarc文件中。

在终端中运行以下命令：

conda config --append channels conda-forge

在防火墙或代理后使用Anaconda（可选）#

一些公司有安全政策，阻止其网络与外部服务器（如Anaconda）进行通信。在这种情况下，您需要连接到公司的防火墙/代理服务器才能成功下载包。

要连接到防火墙/代理服务器，您需要在.condarc文件中包含一个proxy_servers:部分，该部分包含代理服务器的URL。此条目还必须包含用于登录代理服务器的用户名和密码。如果您没有此信息，请与您的IT管理员联系。

没有命令可以包含.condarc文件的这一部分，因此您需要手动包含以下行：

注意

如果您的密码包含特殊字符，您需要按照此处描述使用百分比编码进行转义。

# Replace <USERNAME> with the username for your proxy server
# Replace <PASSWORD> with the password for your proxy server
# Replace <URL> with the URL to your proxy server
proxy_servers:
 http: http://<USERNAME>:<PASSWORD>@<URL>:8080
 https: https://<USERNAME>:<PASSWORD>@<URL>:8443

您还需要与您的IT团队合作，一旦您配置了与防火墙/代理服务器的连接，就将主要软件包仓库的连接加入白名单。主要软件包仓库包括：

  • https://anaconda.org

  • https://repo.anaconda.com

  • https://repo.anaconda.cloud

在某些情况下，需要导出HTTP_PROXY和HTTPS_PROXY环境变量以使用代理服务器。要导出您的环境变量，请打开终端并运行以下命令：

# Replace <USERNAME> with the username for your proxy server
# Replace <PASSWORD> with the password for your proxy server
# Replace <URL> with the URL to your proxy server
export HTTP_PROXY=http://<USERNAME>:<PASSWORD>@<URL>:8080
export HTTPS_PROXY=https://<USERNAME>:<PASSWORD>@<URL>:8443

有关在代理服务器后使用conda的更多信息，请参阅Configure conda for use behind a proxy server。

验证您的配置#

测试您的配置并验证conda是否从Navigator或CLI中的所需渠道下载包：

  1. 转到左侧导航中的环境，然后在窗口底部选择创建。

  2. 为您的环境输入一个名称并从下拉菜单中选择一个Python版本（推荐3.11），然后点击创建。

  3. 将包选择器更改为未安装。这将显示您可以从您的频道获取但尚未安装在您的机器上的包。

  4. 如果您知道所需包的名称，可以在搜索栏中输入以定位该包。选择一个包进行下载并点击应用。

  5. 点击应用以安装选定的包（及其依赖项）。

注意

如果配置正确，Channel 列将显示您组织的渠道路径。

  1. 通过运行以下命令创建一个环境：

    # Replace <ENV_NAME> with a name for your environment
conda create --name <ENV_NAME>

  2. 通过运行以下命令验证您的环境是否成功创建：

    conda env list

  3. 通过运行以下命令激活您的环境：

    # Replace <ENV_NAME> with the name of your environment
conda activate <ENV_NAME>

  4. 通过运行以下命令安装一个包：

    # Replace <PKG_NAME> with the name of the package you want to download from your channel
conda install <PKG_NAME>

  5. 如有必要，您可以通过运行以下命令来删除环境：

    # Replace <ENV_NAME> with the name of your environment
conda env remove --name <ENV_NAME>

额外的conda命令

conda info 命令提供了关于当前活动环境的信息（包括您的 .condarc 文件的位置）。

conda --help 命令提供了可用参数的列表、它们功能的简要描述以及其他包中的附加命令列表。

这个 conda 速查表 包含了一系列常见的 conda 命令及其功能的简要说明，并附有示例。

On this page