WSL2导入MacOS导出Conda环境时依赖冲突无法安装PIP

问题根源 #

跨系统（MacOS → WSL2 Linux）直接复用Conda环境文件必然会出问题：

• conda env export生成的environment.yml包含大量MacOS专属的平台特定包（比如python.app、pyobjc系列）和二进制依赖，这些包在Linux的Conda仓库中不存在，导致ResolvePackageNotFound。
• conda list --export和pip freeze锁定了精确版本，但不同操作系统的包依赖树、二进制兼容性差异极大，强行安装会触发大量版本冲突，甚至导致pip本身无法正常工作。

分步解决方案 #

1. 生成跨平台兼容的Conda环境定义

让同事重新生成环境文件，只保留核心依赖，剔除平台特定内容：

• 执行conda env export --from-history，这个命令只会导出手动安装的包及指定版本，不会包含自动安装的子依赖和平台专属包。
• 如果必须用完整环境文件，手动编辑environment.yml：
  • 删除所有MacOS专属包（比如带osx-64标签的包、python.app等）；
  • 放宽非关键包的版本限制（比如把python=3.9.13改成python>=3.9,<3.11），给Conda留足版本协商空间。

2. 创建Conda基础环境

在WSL2中执行：

# 优先用conda-forge频道，包更全兼容性更好
conda env create -f cleaned_environment.yml -c conda-forge

如果仍有包找不到，检查包名是否正确，或者添加对应Conda频道（比如bioconda针对生物信息包）。

3. 安全处理Pip依赖

不要直接使用MacOS生成的pip freeze文件，按以下步骤操作：

• 让同事生成仅包含手动通过pip安装的包的需求文件，可执行：

  pip freeze --exclude-editable | grep -v "^-e" | grep -v "^#" > pip_requirements.txt
  

  （或者手动整理，删除所有Conda已管理的包，比如numpy、pandas这类通常由Conda安装的包）
• 激活Conda环境后，先升级pip到最新版：

  pip install --upgrade pip
  

• 安装pip依赖时，使用--no-deps避免pip覆盖Conda的依赖：

  pip install --no-deps -r pip_requirements.txt
  

• 如果仍有冲突，逐个安装pip包，定位冲突源，调整版本限制（比如把==2.1.0改成>=2.0,<3.0）。

4. 修复系统级依赖问题

部分Python包依赖Linux系统库，在WSL2的Ubuntu环境下，先安装基础编译和依赖库：

sudo apt-get update && sudo apt-get install build-essential libssl-dev libffi-dev python3-dev

如果是ARM架构的WSL2，需要确保安装的包支持ARM64，否则可能需要源码编译。

长期预防 #

• 团队统一使用conda env export --from-history生成环境文件，避免平台依赖污染；
• 尽量用Conda管理所有依赖，减少Conda与pip的混合使用，从源头减少冲突；
• 若必须用pip，单独维护pip需求文件，明确区分Conda和pip的包范围。

内容的提问来源于stack exchange，提问作者Alex Abades Grimes