RUNBOOK / Conda
conda env create 使用错误环境文件：--file、名称与路径优先级
在非项目目录执行 conda env create 后，环境没有按预期名称创建，或读取了错误的 environment.yml。
故障现象与判断依据
最可能原因
官方命令将 environment.yml 作为默认定义文件；文件中的 name 会生效，除非使用 -n/--name 覆盖。脱离文件目录时必须用 -f 指定路径。
LOGusage: conda env create [-h] [-f [FILE ...]] [-n ENVIRONMENT | -p PATH]
-f, --file Environment definition file (default: environment.yml)安全诊断
以下命令用于读取状态、验证解析或复现请求；先确认目标主机、权限与影响范围。命令中的占位符必须替换为当前环境的实际值。
READ / VERIFYconda env create --file /absolute/path/environment.yml --name project-env
conda env list
# 仅在确认名称和前缀后再执行：
# conda env remove --name project-env推荐修复步骤
- 1先以绝对路径确认要使用的环境定义文件，不要依赖当前目录猜测。
- 2执行 conda env create --file /absolute/path/environment.yml --name project-env，将目标名称显式写出。
- 3用 conda env list 确认实际前缀；若创建到了错误目标，先核对路径和名称后再移除那个明确的测试环境。
验证、限制与回滚
修复后的验证
conda env list 显示预期名称与前缀；重新打开 shell 后 conda activate project-env 可进入同一环境。
风险提示与回滚
不要以关闭证书校验、删除全部缓存、无限重试、关闭防火墙或放宽到 chmod 777 来替代根因定位。任何配置变更前先保留原文件和校验结果；若验证失败，恢复该备份并重新采集日志。
可信来源与适用边界
参考来源conda env create — conda documentation ↗
-f/--file defaults to environment.yml; -n/--name overrides a file name 此页将环境级案例与本 Runbook 的检查步骤分开呈现，不能把示例日志当作当前服务器的真实事件。