macOS下conda已安装模块仍报ModuleNotFoundError如何排查解决

核心问题判断 #

本地存在两套独立Anaconda安装路径：残留旧安装目录/Users/me/opt/anaconda3、当前生效安装目录/opt/anaconda3，环境注册信息混乱、IDE绑定的Python解释器和包实际安装路径不匹配，是导致ModuleNotFoundError的直接原因。手动追加错误路径到sys.path无法解决问题，因为残留目录下根本没有对应包文件，还可能触发二进制依赖冲突。

操作步骤 #

• 确认当前运行环境的真实Python路径
  不管是在RStudio还是Jupyter Notebook中，先执行以下代码，输出的路径才是当前会话实际调用的解释器，不要以Anaconda Navigator显示的路径为准：

  import sys
  print(sys.executable)
  

• 清理无效的conda环境注册条目
  回到终端执行以下命令，删除残留的无效环境路径记录：

  conda config --remove envs_dirs /Users/me/opt/anaconda3
  

  执行完成后再运行conda info --envs，确认无名称的/Users/me/opt/anaconda3条目消失即可，此时Anaconda Navigator中多余的anaconda3环境也会同步移除。
• 重新绑定IDE的Python解释器
  • Jupyter Notebook配置：先激活你要使用的conda环境（比如默认base环境执行conda activate base），依次执行以下命令安装并注册对应环境的内核：

    conda install ipykernel
    python -m ipykernel install --user --name=base
    

    重启Jupyter后，内核选择刚注册的base内核即可，不要使用默认的全局Python内核。
  • RStudio配置：打开顶部菜单栏Tools > Global Options > Python，手动选择解释器路径：使用base环境就选/opt/anaconda3/bin/python，使用其他虚拟环境就选/opt/anaconda3/envs/你的环境名/bin/python，选择完成后重启RStudio生效。
• 验证包安装匹配性
  解释器切换完成后，在对应环境下执行conda list cartopy检查包是否存在，如果查询不到，直接在当前激活的环境中重新安装即可：

  conda install -c conda-forge cartopy rioxarray xarray
  

  注意：不要通过手动修改sys.path的方式跨目录导包，cartopy、rioxarray这类带大量C/C++地理空间依赖的库，路径不匹配时就算能找到包文件，也会触发动态链接库加载失败的报错。

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