conda安装xesmf后导入报错：No module named 'ESMF'

问题场景 #

使用命令 conda install -c conda-forge --override-channels xesmf 将xESMF安装到现有conda环境后，执行 import xesmf as xe 时出现如下错误：

Traceback (most recent call last):
  File "<python-input-0>", line 1, in <module>
    import xesmf
  File "/opt/conda/envs/geo/lib/python3.9/site-packages/xesmf/__init__.py", line 4, in <module>
    from . frontend import Regridder
  File "/opt/conda/envs/geo/lib/python3.9/site-packages/xesmf/frontend.py", line 10, in <module>
    from . backend import (esmf_grid, esmf_locstream, add_corner,
                           esmf_regrid_build, esmf_regrid_finalize)
  File "/opt/conda/envs/geo/lib/python3.9/site-packages/xesmf/backend.py", line 19, in <module>
    import ESMF
ModuleNotFoundError: No module named 'ESMF'

因现有环境已安装大量包，不愿通过新建环境解决问题。

解决方案 #

1. 单独安装ESMF依赖包 #

conda-forge频道提供的ESMF包名为小写的 esmf，直接执行以下命令安装：

conda install -c conda-forge esmf

若出现版本冲突，先搜索与当前Python 3.9兼容的ESMF版本：

conda search -c conda-forge esmf | grep py39

选择合适的版本号进行安装，例如（版本号需根据搜索结果调整）：

conda install -c conda-forge esmf=8.4.0=py39h2b92418_0

2. 重新安装xESMF并自动处理依赖 #

之前使用 --override-channels 可能限制了conda对依赖包的获取，去掉该参数重新安装xESMF，让conda自动解析并安装所有依赖：

conda install -c conda-forge xesmf

3. 验证安装 #

安装完成后，重新导入xESMF验证：

import xesmf as xe
print(xe.__version__)

原因说明 #

xESMF依赖ESMF库及其Python绑定，conda-forge频道中的对应包为小写的 esmf（而非报错中显示的大写 ESMF）。使用 --override-channels 可能导致conda无法自动拉取依赖包，或现有环境的版本冲突导致依赖未被正确安装，通过上述步骤可修复依赖缺失问题。

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