解决已装Miniconda的Google Colab导入模块时的ModuleNotFoundError问题

核心原因 #

Colab默认使用系统自带的Python解释器，而conda安装的包仅存在于conda创建的独立环境中，环境路径未同步到Colab当前的Python搜索路径，导致包在conda list中可见但无法被导入。

具体解决步骤 #

• 检查Python路径差异
  运行以下命令对比Colab当前Python与conda环境Python的路径：

  !which python
  !conda run which python
  

  若输出路径不同，说明两者不属于同一环境。

• 指定conda环境的Python路径

  1. 先创建并激活目标conda环境（以Python3.8.16为例）：

     !conda create -n my_dev_env python=3.8.16 -y
     !source /usr/local/etc/profile.d/conda.sh && conda activate my_dev_env
     !conda install -c conda-forge 你的关键包名称 -y
     

  2. 获取conda环境的site-packages路径：

     !conda run -n my_dev_env python -c "import site; print(site.getsitepackages()[0])"
     

  3. 将该路径添加到Python搜索路径中：

     import sys
     sys.path.append("/path/to/conda/env/site-packages")  # 替换为上一步输出的路径
     

• 重启内核验证
  点击Colab菜单栏的Runtime -> Restart runtime，重启后尝试导入目标包，验证是否可用。

• 持久化环境激活
  若每次重启后都需要重新激活环境，可在笔记本开头添加以下命令确保conda环境被正确加载：

  !source /usr/local/etc/profile.d/conda.sh && conda activate my_dev_env
  

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