conda create
#
从指定包列表中创建一个新的 conda 环境。
要使用新创建的环境,请使用“conda activate envname”。此命令需要 -n NAME 或 -p PREFIX 选项。
usage: conda create [-h] [--clone ENV] [-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]
[--no-default-packages] [--subdir SUBDIR]
[--solver {classic}] [-m] [--dev]
[package_spec ...]
位置参数#
- package_spec
要在 conda 环境中安装或更新的包列表。
命名参数#
- --clone
创建一个新的环境作为现有本地环境的副本。
- --file
从给定文件中读取包版本。可以传递重复的文件规范(例如 --file=file1 --file=file2)。
- -m, --mkdir
--mkdir 即将弃用,将在 25.3 中删除。冗余参数。
- --dev
在包装脚本中使用 sys.executable -m conda 而不是 CONDA_EXE。这主要用于测试期间,我们针对旧 Python 版本测试新的 conda 源。
目标环境规范#
- -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。默认情况下启用。(默认值:Null)
- --subdir, --platform
可能的选择:emscripten-wasm32, wasi-wasm32, freebsd-64, linux-32, linux-64, linux-aarch64, linux-armv6l, linux-armv7l, linux-ppc64, linux-ppc64le, linux-riscv64, linux-s390x, osx-64, osx-arm64, win-32, win-64, win-arm64, zos-z
使用为此平台构建的包。新的环境将配置为记住此选择。应格式化为“osx-64”、“linux-32”、“win-64”等。默认为当前(本机)平台。
求解器模式修饰符#
- --strict-channel-priority
如果具有相同名称的包出现在较高优先级的频道中,则不会考虑较低优先级的频道中的包。
- --no-channel-priority
包版本优先于频道优先级。覆盖 conda config --show channel_priority 给出的值。
- --no-deps
不要安装、更新、删除或更改依赖项。这将导致环境损坏和行为不一致。使用风险自负。
- --only-deps
仅安装依赖项。
- --no-pin
忽略固定文件。
- --no-default-packages
忽略 .condarc 文件中的 create_default_packages。
- --solver
可能的选择:classic
选择要使用的求解器后端。
包链接和安装时选项#
- --copy
使用副本安装所有包,而不是使用硬链接或软链接。
- --no-shortcuts
不要安装开始菜单快捷方式
- --shortcuts-only
仅为此包名称安装快捷方式。可以多次使用。
网络选项#
- -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
自动将所有确认值设置为“是”。用户不会被要求确认任何添加、删除、备份等操作。
- --download-only
解决环境并确保包缓存已填充,但在将包取消链接和链接到前缀之前退出。
- --show-channel-urls
显示频道 URL。覆盖 conda config --show show_channel_urls 给出的值。
示例
创建一个包含包“sqlite”的环境
conda create -n myenv sqlite
创建一个环境(env2)作为现有环境(env1)的克隆
conda create -n env2 --clone path/to/file/env1