MacOS Sonoma下conda-lock无法生成锁文件，仅返回帮助信息

问题背景 #

按照StackOverflow问答《Does it make sense to use Conda + Poetry?》中kxmh42的回答尝试使用conda-lock，但无论搭配何种命令行参数，工具都只返回帮助信息，无法生成锁文件。试过通过conda-forge和HomeBrew安装的conda-lock（conda最初由brew安装），结果完全一致。执行命令conda-lock lock -k 'explicit' --log-level DEBUG后返回的帮助信息（已翻译为中文）如下：

test % conda-lock lock -k 'explicit' --log-level DEBUG
用法: conda-lock lock [选项]

为conda环境生成完全可复现的锁文件。

默认情况下，多平台锁文件会写入conda-lock.yml。

当选择"explicit"或"env"类型时，锁文件会写入conda-{platform}.lock。可通过--filename-template参数自定义这些文件名。可用变量如下：

platform: 生成该锁文件的平台（conda子目录）。
  dev-dependencies: 该锁文件是否包含开发依赖。
  input-hash: 锁文件输入规格的sha256哈希值。
  version: 用于生成该锁文件的conda-lock版本。
  timestamp: 输出文件的近似ISO8601基础格式时间戳。

选项:
--conda TEXT 要使用的conda/mamba可执行文件路径（或名称）。
--mamba / --no-mamba 不要尝试使用或安装mamba。
--micromamba / --no-micromamba 不要尝试使用或安装micromamba。
-p, --platform TEXT 为指定平台生成锁文件
-c, --channel TEXT 覆盖求解环境时使用的通道，替换各源文件中列出的通道。
--dev-dependencies / --no-dev-dependencies
在锁文件中包含开发依赖（如适用）
-f, --file PATH conda环境规格文件的路径
-k, --kind TEXT 要生成的锁文件类型[可选值：'lock'、'explicit'或'env']。
--filename-template TEXT 单平台（explicit、env）锁文件的名称模板，必须包含{platform}变量，且不能以'.yml'结尾。
--lockfile TEXT 要创建或更新的conda-lock.yml路径
--strip-auth 从锁文件中移除基础认证凭据。
-e, --extras, --category TEXT 结合支持额外依赖/分类的输入源（如pyproject.toml）使用时，将对应额外依赖添加到渲染规格中
--filter-categories, --filter-extras
与额外依赖搭配使用时，加载文件时剔除未指定额外依赖的项。
--check-input-hash 重新生成锁文件前检查现有锁文件的输入哈希值，若无文件更新则以退出码4退出，与--strip-auth不兼容
--log-level [DEBUG|INFO|WARNING|ERROR|CRITICAL]
日志级别。
--pdb 若conda-lock崩溃，进入事后调试器
--virtual-package-spec PATH 指定要使用的虚拟包集合。
--update TEXT 要更新到最新版本的包，为空则更新所有包。
--pypi_to_conda_lookup_file TEXT
包含Pypi包名到conda名映射的查找文件位置。
--md, --metadata [timestamp|git_sha|git_user_name|git_user_email|input_md5|input_sha]
要包含在锁文件中的元数据字段
--with-cuda TEXT 指定虚拟包中要使用的CUDA版本，避免隐式接受CUDA依赖的警告，若已指定虚拟包则忽略此选项。
--without-cuda 在虚拟包中禁用CUDA，防止接受包的CUDA变体，若已指定虚拟包则忽略此选项。
--mdy, --metadata-yaml, --metadata-json PATH
包含要添加到锁文件元数据部分的结构化元数据的YAML或JSON文件。
--help 显示此帮助信息并退出。

解决方法 #

1. 补充必填的环境配置文件参数 #

conda-lock生成锁文件的核心前提是指定环境配置来源，你的命令中缺少了-f/--file参数来指向环境配置文件（比如environment.yml或pyproject.toml），这是工具要求的必填项，缺失时会直接返回帮助信息提示补全。

• 若使用传统conda环境文件environment.yml，执行命令：

conda-lock lock -k 'explicit' --log-level DEBUG -f environment.yml

• 若使用Poetry的pyproject.toml作为配置源，执行命令：

conda-lock lock -k 'explicit' --log-level DEBUG -f pyproject.toml

2. 排查其他可能问题 #

• 更新conda-lock版本：老旧版本可能存在参数兼容或bug，执行对应命令更新：
  • Homebrew安装：brew upgrade conda-lock
  • conda-forge安装：conda update -c conda-forge conda-lock
• 确认conda环境状态：虽不强制要求激活环境，但部分环境变量异常可能导致工具行为异常，可尝试激活base环境后再运行命令：

conda activate base
conda-lock lock -k 'explicit' --log-level DEBUG -f your_env_file.yml

内容的提问来源于stack exchange，提问作者aggedor2