`conda install`#

将一组包安装到指定的 Conda 环境中。

此命令接受一组包规范（例如，bitarray=0.8），并安装与这些规范一致且与底层环境兼容的一组包。如果无法保证完全兼容性，则会报告错误，并且环境不会改变。

Conda 尝试安装请求的包的最新版本。为了实现这一点，它可能会更新已安装的某些包，或安装其他包。要防止现有包更新，请使用 --freeze-installed 选项。这可能会强制 conda 安装请求包的旧版本，并且不会阻止安装其他依赖包。

如果您希望完全跳过依赖项检查，请使用 '--no-deps' 选项。这可能会导致环境包含不兼容的包，因此必须非常谨慎地使用此选项。

conda 也可以使用一组明确的 conda 包文件名（例如 ./lxml-3.2.0-py27_0.tar.bz2）调用。在这种模式下使用 conda 意味着使用 --no-deps 选项，并且同样应谨慎使用。明确的文件名和包规范不能在一个命令中混合使用。

usage: conda install [-h] [--revision REVISION] [-n ENVIRONMENT | -p PATH]
                     [-c CHANNEL] [--use-local] [--override-channels]
                     [--repodata-fn REPODATA_FNS] [--experimental {jlap,lock}]
                     [--no-lock] [--repodata-use-zst | --no-repodata-use-zst]
                     [--strict-channel-priority] [--no-channel-priority]
                     [--no-deps | --only-deps] [--no-pin] [--copy]
                     [--no-shortcuts] [--shortcuts-only SHORTCUTS_ONLY] [-C]
                     [-k] [--offline] [--json] [-v] [-q] [-d] [-y]
                     [--download-only] [--show-channel-urls] [--file FILE]
                     [--solver {classic}] [--force-reinstall]
                     [--freeze-installed | --update-deps | -S | --update-all | --update-specs]
                     [-m] [--clobber] [--dev]
                     [package_spec ...]

位置参数#

package_spec: 要安装或更新到 Conda 环境中的包列表。

命名参数#

--revision: 还原到指定的 REVISION。
--file: 从给定文件中读取包版本。可以传递重复的文件规范（例如 --file=file1 --file=file2）。
--dev: 在包装脚本中使用 sys.executable -m conda 而不是 CONDA_EXE。这主要用于测试，在测试中，我们测试新 conda 源代码与旧 Python 版本的兼容性。

目标环境规范#

-n, --name: 环境的名称。
-p, --prefix: 环境位置（即前缀）的完整路径。

频道定制#

-c, --channel

搜索包的附加频道。这些是按给定顺序搜索的 URL（包括使用 'file://' 语法或仅仅是像 '/home/conda/mychan' 或 '../mychan' 这样的路径的本地目录）。然后，将搜索默认值或来自 .condarc 的频道（除非给出 --override-channels）。您可以使用 'defaults' 获取 Conda 的默认包。您还可以使用任何名称，并且会预先添加 .condarc channel_alias 值。默认 channel_alias 是 https://conda.anaconda.org/。

--use-local

使用本地构建的包。与 '-c local' 相同。

--override-channels

不要搜索默认值或 .condarc 频道。需要 --channel。

--repodata-fn

指定频道配置的远程服务器上的 repodata 文件名，或在本地备份中指定文件名。Conda 会尝试您指定的任何内容，但最终会回退到 repodata.json，如果您指定的规范不能满足您在此处指定的规范。这用于使用大小更小且时间范围更短的 repodata。您可以多次传递此标志。最左边的条目首先尝试，自动为您添加回退到 repodata.json。有关更多信息，请参见 conda config --describe repodata_fns。

--experimental

可能的选择：jlap、lock

jlap：从 repodata.jlap 下载增量包索引数据；这意味着 'lock'。lock：在读取、更新索引（repodata.json）缓存时使用锁定。现在已启用。

--no-lock

在读取、更新索引（repodata.json）缓存时禁用锁定。

--repodata-use-zst, --no-repodata-use-zst

检查 repodata.json.zst 或不检查。默认情况下启用。（默认：空）

求解器模式修饰符#

--strict-channel-priority

如果具有相同名称的包出现在较高优先级的频道中，则不会考虑较低优先级的频道中的包。

--no-channel-priority

包版本优先于频道优先级。覆盖由 conda config --show channel_priority 给出的值。

--no-deps

不要安装、更新、删除或更改依赖项。这将导致环境崩溃和行为不一致。后果自负。

--only-deps

仅安装依赖项。

--no-pin

忽略固定文件。

--solver

可能的选择：classic

选择要使用的求解器后端。

--force-reinstall

确保对当前操作的任何用户请求的包都被卸载并重新安装，即使该包已存在于环境中。

--freeze-installed, --no-update-deps

不要更新或更改已安装的依赖项。

--update-deps

更新具有可用更新的依赖项。

-S, --satisfied-skip-solve

如果满足请求的规范，则尽早退出，并且不运行求解器。还会跳过由 'aggressive_update_packages' 配置设置配置的积极更新。使用 'conda config --describe aggressive_update_packages' 查看您的设置。--satisfied-skip-solve 类似于 'pip install' 的默认行为。

--update-all, --all

更新环境中所有已安装的包。

--update-specs

根据提供的规范更新。

包链接和安装时选项#

--copy: 使用复制而不是硬链接或软链接安装所有软件包。
--no-shortcuts: 不要安装开始菜单快捷方式
--shortcuts-only: 仅为该软件包名称安装快捷方式。可以多次使用。
-m, --mkdir: --mkdir 即将弃用，将在 25.3 中删除。请使用 conda create 代替。
--clobber: 允许覆盖（即覆盖）软件包内重叠的文件路径并抑制相关警告。

网络选项#

-C, --use-index-cache: 使用频道索引文件的缓存，即使它已过期。如果您不想让 conda 检查 repodata 文件的新版本是否存在，这很有用，这将节省带宽。
-k, --insecure: 允许 conda 执行“不安全的”SSL 连接和传输。等效于将“ssl_verify”设置为“false”。
--offline: 离线模式。不要连接到互联网。

输出、提示和流程控制选项#

--json: 将所有输出报告为 json。适合以编程方式使用 conda。
-v, --verbose: 可以多次使用。一次用于详细输出，两次用于 INFO 日志记录，三次用于 DEBUG 日志记录，四次用于 TRACE 日志记录。
-q, --quiet: 不显示进度条。
-d, --dry-run: 仅显示将要执行的操作。
-y, --yes: 自动将所有确认值设置为“yes”。不会要求用户确认任何添加、删除、备份等操作。
--download-only: 解决环境并确保软件包缓存已填充，但在将软件包从链接解除并链接到前缀之前退出。
--show-channel-urls: 显示频道网址。覆盖 conda config --show show_channel_urls 给定的值。

示例

将软件包“scipy”安装到当前活动的 environment 中

conda install scipy

将软件包列表安装到一个名为“myenv”的 environment 中

conda install -n myenv scipy curl wheel

将特定版本的“python”安装到一个名为“myenv”的 environment 中

conda install -p path/to/myenv python=3.11

conda install#