conda env create 深度指南从环境定义文件创建 conda 环境【免费下载链接】condaA system-level, binary package and environment manager running on all major operating systems and platforms.项目地址: https://gitcode.com/GitHub_Trending/co/condaconda env create是 conda 中专门用于“依据环境定义文件environment definition file批量创建环境”的命令它按文件名或文件内容自动识别文件格式YAML 环境文件、explicit 锁定文件、requirements 文本等解析出环境名、渠道与依赖再走 conda 标准的求解-安装流程完成环境落地。读完本文你将掌握该命令的完整参数体系、内置输入格式插件、目标前缀prefix冲突处理规则以及从conda/cli/main_env_create.py到conda/cli/install.py的完整执行链路能够在 CI 与日常开发中可靠地复现环境。文档页与命令帮助的同源机制官方文档页 docs/source/commands/env/create.rst 本身并不手写内容而是通过 Sphinx 的argparse指令在构建时自动渲染.. argparse:: :module: conda.cli.conda_argparse :func: generate_parser :prog: conda :path: env create :nodefault: :nodefaultconst:也就是说文档页展示的就是conda env create --help的实时输出其唯一事实来源是 conda/cli/main_env_create.py 中的configure_parser()与epilog()。本文下面列出的所有选项与默认值均出自该文件及其引用的 conda/cli/helpers.py因此不会与你的实际安装版本脱节。conda env是conda-env风格的命令族入口在 conda/cli/main_env.py 中注册了config、create、export、list、remove、update六个子命令create的 parser 通过p.set_defaults(funcconda.cli.main_create.execute, env_createTrue, ...)将执行委托给与conda create共用的核心逻辑见 conda/cli/main_env_create.py从而保证两条命令的求解与安装行为完全一致仅在入参形态上不同conda env create不提供位置参数包名与--clone只接受环境定义文件。命令描述与核心行为configure_parser()中给出的官方描述conda/cli/main_env_create.py要点如下该命令“Create an environment based on an environment definition file.”即环境的唯一输入是定义文件文件格式从文件名或内容检测detected from the filename or contents支持哪些格式取决于你环境中安装的环境格式插件--help的 epilog 会列出当前可用的格式清单若文件内容中声明了环境名例如environment.yml首部的name:字段除非用命令行-n/--name显式覆盖否则以文件声明为准除非你正处于包含定义文件的目录否则必须用-f指定文件路径。与conda create对比时需要注意两点差异对比 conda/cli/main_create.py 与 conda/cli/main_env_create.pyconda env create的-f/--file默认值为[environment.yml]nargs*即不带--file时会在当前目录寻找environment.yml而conda create的--file是actionappend、默认空列表且要求-n/-p之一。conda env create的 parser 只挂载了 prefix、networking、environment specifier、default packages、output、solver、platform 七组选项add_parser_prefix、add_parser_networking等见 conda/cli/helpers.py没有渠道组-c/--channel、--override-channels等因此渠道配置来自环境文件内的channels:段或.condarc不能通过该命令的命令行渠道参数覆盖——这是从源码结构看的一个明确约束。完整参数一览以下参数均来自conda env create实际挂载的 parser 组帮助文本引自 conda/cli/helpers.py可按组理解目标环境Target Environment Specification参数说明-n/--name ENVIRONMENT环境名。与-p互斥。-p/--prefix PATH环境所在完整路径前缀。与-n互斥。注意-n/-p并非强制命令行选项——若定义文件内声明了nameexecute()会先读取文件并回填args.name见下文“名称与前缀的确定逻辑”。输入文件与环境格式参数说明-f/--file [FILE ...]环境定义文件默认environment.yml。已注册的格式插件的标准文件名如explicit.txt、requirements.txt会被自动识别自定义文件名需要配合--format显式指定。--format FORMAT覆盖文件格式的自动检测。可用格式即当前安装中注册的环境格式插件别名aliases与规范名可互换使用。--environment-specifier/--env-spec已废弃deprecated提示改用--format仅为兼容旧脚本保留。--no-default-packages忽略.condarc中的create_default_packages设置创建时不注入默认包。网络选项Networking Options参数说明-C/--use-index-cache即使渠道索引缓存已过期也继续使用不检查 repodata 是否有新版本节省带宽。-k/--insecure允许“不安全”的 SSL 连接与传输等价于把ssl_verify设为false。--offline离线模式不访问互联网。输出、交互与流程控制Output, Prompt, and Flow Control Options参数说明--json以 JSON 报告全部输出适合程序化调用 conda。--console NAME选择正常输出渲染使用的 reporter backend可用值由已注册的 reporter backend 插件动态决定见 conda/cli/helpers.py。-v/--verbose可重复使用一次为详细输出两次为 INFO 日志三次 DEBUG四次 TRACE。-q/--quiet不显示进度条同时抑制结尾的 activate 提示打印。-d/--dry-run只显示将执行的操作而不实际执行。-y/--yes自动对所有确认提问回答“yes”不再询问添加、删除、备份等。对于conda env create执行入口还会强制args.yes Trueconda/cli/main_create.py即 env create 的安装阶段默认不再逐项确认。求解器与平台参数说明--solver FORMAT选择求解器后端。可选值不是写死的而是通过LazyChoicesAction从插件管理器动态枚举context.plugin_manager.get_solvers因此取当前安装注册的求解器列表见 conda/cli/helpers.py。--subdir/--platform SUBDIR为指定平台安装包如osx-64、linux-32、win-64新环境会被配置为记住这一选择取值范围是context.known_subdirs去掉noarch后的排序列表默认使用当前原生平台。内置支持的输入文件格式epilog 中的格式清单由插件系统动态生成epilog()调用context.plugin_manager.get_environment_specifiers_grouped()取回“格式 - 插件”分组再由 conda/cli/formats.py 的get_available_environment_formats()渲染为“Environment specs / Lockfiles”分类的子弹列表含别名与标准文件名。conda 内置注册了四个环境格式插件清单见 conda/plugins/environment_specifiers/init.py插件名别名标准文件名分类说明environment.yml—environment.yml,environment.yamlEnvironment specs标准 YAML 环境声明含name、channels、dependencies等段安装时求解。cep-24environment-yaml,env.ymlenvironment.yml,environment.yamlEnvironment specsCEP-24 规范的 YAML 环境声明注册时带tryfirstTrue即同名文件优先按该格式解析见 conda/plugins/environment_specifiers/cep_24.py。requirements.txtrequirements,reqsrequirements.txt,spec.txtEnvironment specs简单的“每行一个包规格”文本文件。explicit—explicit.txtLockfiles显式包 URL 列表锁文件不经过求解用于逐位精确复现环境。每个插件通过CondaEnvironmentSpecifier声明name、aliases、environment_spec解析类、default_filenames与environment_format如 explicit 被标记为EnvironmentFormat.lockfile见 conda/plugins/environment_specifiers/explicit.py。由于格式完全插件化第三方插件注册新格式后--help的 epilog 与--format的可选值会自动包含它——tests/cli/test_main_env_create.py 的test_epilog正是通过注册DummyEnvSpecPlugin/DummyLockfilePlugin四种组合来验证这一动态渲染行为。典型用法epilog 示例原文epilog()内置的官方示例conda/cli/main_env_create.py覆盖三种最常见路径Examples: Create from an environment spec (solved at install time): conda env create -f /path/to/environment.yml Create from a lockfile (no solve, exact reproduction): conda env create -f explicit.txt Use the default file in the current directory: conda env create conda env create -n envname即环境声明文件安装时求解conda env create -f /path/to/environment.yml锁文件不求解、逐位复现conda env create -f explicit.txt当前目录默认文件conda env create直接读取当前目录的environment.yml需要指定名字时conda env create -n envname。注意示例中-f的值可以是任意路径只要文件名命中某个插件的default_filenames例如explicit.txt、requirements.txt即自动识别格式只有自定义文件名才需要--format。名称与前缀的确定逻辑conda env create对“环境建在哪里”的裁决顺序在 conda/cli/main_create.py 中实现逻辑可归纳为若命令行给了-n或-p直接使用不再看文件否则若指定了多个--file且没有-n/-p直接报ArgumentError无法从多个文件中确定唯一目标否则调用 conda/cli/common.py 的get_name_prefix_from_env_file()解析第一个文件通过插件管理器选出格式钩子实例化其environment_spec读取env.name/env.prefix该函数“intentionally swallows all errors”解析失败仅记日志因此文件读不出名字时会落入第 4 步报错文件声明了名字/前缀就回填到args并重新初始化context若仍无任何名字或前缀且不是--dry-run/--download-only抛出one of the arguments -n/--name -p/--prefix is required--dry-run或--download-only且无名字/前缀时会临时用os.path.join(mktemp(), UNUSED_ENV_NAME)作为虚拟前缀继续走流程便于预演而不落盘。此外execute()开头还有两组前置校验每个args.file都经validate_file_exists()检查存在性支持 conda 会话可用的 URL 方案file://会展开为本地路径不存在抛EnvironmentFileNotFound多个文件时经validate_environment_files_consistency()校验格式一致性所有文件必须能被解析为同一格式混用例如 YAML explicit 列表抛EnvironmentFileTypeMismatchError见 conda/cli/common.py 中对应实现。目标位置已存在时的行为这是conda env create与conda create/conda install在语义上最值得注意的差异源码见 conda/cli/main_create.py目标前缀已是 conda 环境--dry-run直接拒绝“Cannotcreate --dry-runwith an existing conda environment”若处于env_create模式且未带--yes/always_yes抛出CondaValueError: prefix already exists: path。这一行为由 releases/news/15071-env-create-existing-prefix 引入——“Require confirmation through--yesoralways_yesto replace an existing environment withconda env create”。带--yes时才会打印 “Removing existing environment at ...” 并rm_rf后重建目标只是普通目录非 conda 环境confirm_yn()会询问 “WARNING: A directory already exists at the target location ... Continue creating environment”默认no创建成功后还会执行prefix_data.set_nonadmin()设置非管理员标记并通过 conda/cli/common.py 的print_activate()打印激活提示-q/--json模式下不打印# # To activate this environment, use # # $ conda activate name # # To deactivate an active environment, use # # $ conda deactivate执行链路从 parser 到安装把 conda/cli/main_env_create.py、conda/cli/main_create.py 与 conda/cli/install.py 串起来一次conda env create的完整调用链为解析conda.cli.conda_argparse.generate_parser构建 parser 树env create子 parser 由main_env_create.configure_parser生成conda/cli/conda_argparse.py入口set_defaults(funcconda.cli.main_create.execute, cloneFalse, override_channelsFalse, packages[], env_createTrue)表明 env create 固定cloneFalse、固定override_channelsFalse不覆盖渠道并打上env_createTrue标记校验main_create.execute依次做--clone互斥检查env create 场景clone恒为 False、文件存在性与格式一致性校验、名称/前缀确定、PrefixData.from_context(validateTrue)判断目标是否已是环境、validate_subdir_config()校验跨平台--subdir合法性——非原生 subdir 只允许来自命令行、环境变量或全局/基础环境配置防止激活中的非原生环境把 subdir “泄漏”给新建环境见 conda/cli/common.py安装非 clone 分支调用 conda/cli/install.py 的install(args, parser, create)。该函数是conda [create|install|update|remove]共享的核心它构建Index读取各渠道 repodata、用求解器--solver选定解析依赖、生成UnlinkLinkTransaction完成下载与链接。explicit 锁文件路径则走 conda/misc.py 的install_explicit_packages跳过求解收尾set_nonadmin()print_activate()打印激活提示返回 0。--dry-run与--download-only后者在 conda/cli/helpers.py 中定义为“求解并确保包缓存就绪但在 unlink/link 进入 prefix 之前退出”让这条链路可以在不落盘的前提下预演或预热包缓存对 CI 排障很有用。测试用例给出的行为边界tests/cli/test_main_env_create.py 针对该命令固化了三类可验证行为test_epilog参数化“无插件 / 仅 spec 插件 / 仅 lockfile 插件 / 全插件”四种组合断言 epilog 中 “Available input formats:”、“Environment specs:”、“Lockfiles:” 等文本随注册插件的出现与否而正确增减验证了格式清单的动态生成test_env_create_help真实调用conda env create --help断言输出包含env_create_epilog()全文保证--help与文档页同源于 argparse 渲染一致test_env_create_with_invalid_installer注册一个会返回带external_packages的Environment的自定义格式插件断言conda env create --prefix... --file...抛出InvalidInstaller——说明当解析结果需要外部包安装器而 conda 自身不具备时命令会显式失败而不是静默忽略。小结conda env create的设计要点可以浓缩为三句话输入完全由插件化的环境定义文件驱动文件名/内容自动识别--format兜底目标环境的位置可由文件内声明的name决定命令行-n/-p优先它复用了conda create的整套求解-安装管线但语义更严格——不传包名、不传渠道参数且覆盖已存在环境必须显式--yes/always_yes。结合本文给出的源码路径conda/cli/main_env_create.py、conda/cli/main_create.py、conda/plugins/environment_specifiers/、tests/cli/test_main_env_create.py你可以对任何一次conda env create的失败定位到具体环节格式识别、名称/前缀裁决、渠道与 subdir 校验、求解还是链接。【免费下载链接】condaA system-level, binary package and environment manager running on all major operating systems and platforms.项目地址: https://gitcode.com/GitHub_Trending/co/conda创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考