如何在Google Colab或Paperspace Gradient运行本地Conda环境

第一步：本地导出环境配置 #

• 打开本地终端，激活需要迁移的Conda环境：conda activate <你的环境名称>
• 导出依赖配置文件，分两种场景选择命令：
  • 跨架构迁移（本地为Windows/macOS，目标平台为Linux）：执行conda env export --from-history > environment.yml，该命令会过滤平台专属依赖，降低后续安装报错概率
  • 同架构完全复刻：执行conda env export > environment.yml，会保留所有依赖包及版本号
• 将生成的environment.yml文件存储到可访问位置，方便后续上传到目标平台。

第二步：Google Colab环境重建 #

Colab默认未预装Conda，需先完成Miniconda安装：

• 安装Miniconda，在Colab代码块依次执行：

  !wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
  !chmod +x Miniconda3-latest-Linux-x86_64.sh
  !./Miniconda3-latest-Linux-x86_64.sh -b -f -p /usr/local
  

  安装完成后执行以下代码将Conda加入系统路径，将3.x替换为你环境对应的Python大版本号：

  import sys
  sys.path.append('/usr/local/lib/python3.x/site-packages')
  

• 上传environment.yml到Colab，可通过左侧文件栏的上传按钮，或挂载谷歌云盘读取文件
• 执行环境重建命令：!conda env create -f environment.yml
• 环境创建完成后，可通过!conda run -n <你的环境名称> python <脚本路径.py>运行代码，或刷新内核列表后选择对应Conda环境作为Notebook内核。
• 若你使用的Python版本低于3.7，替换Miniconda安装脚本为对应旧版本即可。

第三步：Paperspace Gradient环境重建 #

Paperspace官方镜像默认预装Conda，操作更简便：

• 创建Notebook实例时，选择带Conda的官方基础镜像，按需选择GPU/CPU机型
• 实例启动后，上传environment.yml到实例存储，或从关联的GitHub、云存储拉取配置文件
• 打开实例内终端，执行conda env create -f environment.yml
• 刷新Notebook内核列表，选择刚创建的Conda环境作为运行内核即可。

常见问题处理 #

• 依赖安装报错：优先使用--from-history参数导出的配置文件，手动删除配置中平台专属的依赖项，报错的依赖可后续单独用pip安装
• 内核不显示：环境创建完成后刷新页面，或重启实例内核即可刷新列表
• 运行版本不匹配：核对配置文件中Python版本与创建的环境版本是否一致，避免默认镜像版本冲突

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