Conda 环境打包迁移完整指南：处理可编辑安装包（Editable Packages）

一 迁移环境和问题说明

1.1 适用场景

• 在AutoDL / 本地服务器配置好训练环境，需要迁移到离线集群 / 其他服务器，环境中包含开发中的自定义包（通过pip install -e安装）。

1.2 核心问题

conda-pack无法打包可编辑安装的包（editable packages），报错：

CondaPackError: Cannot pack an environment with editable packages installed

1.3 解决思路

分离打包：环境依赖与源码分离

1. 打包环境时忽略可编辑包（只保留依赖库）。
2. 单独打包源码目录。
3. 在目标机器上重新链接源码。

1.4 注意事项

1. 路径一致性：如果代码中有硬编码的绝对路径（如/autodl-fs/data/...），建议在目标机器保持相同路径结构，或使用软链接：

   sudoln-s /actual/path /autodl-fs/data/EasyR1

2. 权限问题：如果目标机器普通用户无法创建/autodl-fs，可修改源码安装位置，但需同步修改相关配置。
3. 其他可编辑包：如果有多个可编辑包，每个都需要单独打包源码并重新安装。
4. 环境变量：检查~/.bashrc或项目中是否有环境变量依赖，一并迁移。

二 conda环境迁移完整操作步骤

2.1 在源机器（AutoDL）上操作

1. 打包 Conda 环境（忽略可编辑包）

# 进入要保存压缩包的目录cd~/autodl-fs# 打包环境，忽略可编辑安装的包conda pack -p /autodl-fs/data/easy_r1_env\-o easy_r1_env.tar.gz\--ignore-editable-packages

2. 打包 EasyR1 源代码

# 将 EasyR1 源码目录压缩cd/autodl-fs/datatar-czf EasyR1.tar.gz EasyR1

3. 下载文件到本地
   需要下载的文件：

• ~/autodl-fs/easy_r1_env.tar.gz（环境包）

• /autodl-fs/data/EasyR1.tar.gz（源码包）

• 目录结构

迁移文件/ ├── easy_r1_env.tar.gz # 环境包 ├── EasyR1.tar.gz # 源码包 └── restore.sh # 恢复脚本（可选）

2.2 在目标机器上恢复

1. 上传文件到目标机器：将两个压缩包上传到目标机器的合适位置，例如/home/user/或/opt/。
2. 解压并恢复 Conda 环境

# 创建环境目录mkdir-p /path/to/easy_r1_env# 解压环境tar-xzf easy_r1_env.tar.gz -C /path/to/easy_r1_env# 激活环境（此时只是临时激活）source/path/to/easy_r1_env/bin/activate# 修复环境路径（关键步骤！）conda-unpack

3. 解压并安装 EasyR1 源码

# 创建存放源码的目录（建议保持与原路径一致，避免混淆）sudomkdir-p /autodl-fs/datasudotar-xzf EasyR1.tar.gz -C /autodl-fs/data/# 或者放到用户目录mkdir-p ~/projectstar-xzf EasyR1.tar.gz -C ~/projects/

4. 重新安装为可编辑模式

# 确保已激活环境conda activate /path/to/easy_r1_env# 进入源码目录，重新安装为可编辑模式cd/autodl-fs/data/EasyR1# 或你实际解压的路径pipinstall-e.

5. 验证安装

# 检查 EasyR1 是否在可编辑包列表中pip list -e# 测试导入python -c"import EasyR1; print(EasyR1.__file__)"

2.3 自动化恢复脚本（restore.sh）

#!/bin/bash# 在目标机器上运行此脚本ENV_NAME="easy_r1_env"ENV_PATH="/opt/$ENV_NAME"# 修改为你想要的路径SRC_PATH="/autodl-fs/data/EasyR1"# 建议保持原路径，避免代码硬编码问题PROJECT_TAR="EasyR1.tar.gz"echo"=== 1. 解压 Conda 环境 ==="mkdir-p$ENV_PATHtar-xzf${ENV_NAME}.tar.gz -C$ENV_PATHsource$ENV_PATH/bin/activate conda-unpackecho"环境解压完成！"echo"=== 2. 解压项目源码 ==="sudomkdir-p$(dirname$SRC_PATH)sudotar-xzf$PROJECT_TAR-C$(dirname$SRC_PATH)echo"源码解压完成！"echo"=== 3. 重新安装可编辑包 ==="cd$SRC_PATHpipinstall-e.echo"EasyR1 安装完成！"echo"=== 4. 验证 ==="pip list -e|grep-i easyr1&&echo"✅ 迁移成功！"||echo"❌ 请检查"

赋予执行权限并运行：

chmod+x restore.sh ./restore.sh