如何将完整Python虚拟环境从一台Linux机器迁移到另一台同系统设备？

前置匹配要求（不满足则迁移必然失败） #

• 开发机与目标嵌入式设备CPU架构完全一致（如均为aarch64/armv7l/x86_64，不可跨架构迁移）
• 两台设备系统内置Python的大、小版本号完全一致（如同为3.8.10，3.8与3.9版本不可通用）
• 两台设备系统基础C库（glibc/uclibc，依嵌入式系统选型而定）版本差不超过1个次版本号，优先保持完全一致

之前方案失败原因说明 #

• 直接在目标机执行pip install -r requirements.txt卡死：嵌入式设备CPU、内存资源有限，pip安装过程中编译、解压依赖包时资源耗尽触发系统假死
• 直接复制虚拟环境文件夹仅修改activate脚本无效：activate脚本仅修改终端会话的PATH变量，虚拟环境内的python、pip可执行文件、依赖包内置的二进制库中都硬编码了开发机端虚拟环境的绝对路径，仅修改激活脚本无法修正所有路径引用，会触发大量导入错误

开发机端操作步骤 #

1. 重新创建带副本参数的虚拟环境，避免默认软链接指向系统Python文件导致迁移后断链，提前确认虚拟环境内Flask服务可正常运行：

# 新建虚拟环境，--copies参数强制复制所有Python相关文件而非创建软链接
python3 -m venv --copies ./prod_venv
# 激活环境安装所有项目依赖，完整跑通Flask服务验证功能正常
source ./prod_venv/bin/activate
pip install 你的所有项目依赖
# 验证服务正常后退出环境
deactivate

2. 提前确定虚拟环境在目标机的固定绝对路径（后续不可随意更改存放位置），比如目标机计划将虚拟环境存放在/opt/flask_app/venv，而开发机当前虚拟环境的绝对路径为/home/xxx/workspace/prod_venv，执行命令批量替换虚拟环境内所有硬编码的旧路径：

cd ./prod_venv
# 递归查找所有包含旧路径的文件，批量替换为目标机新路径，注意替换为自己的实际路径
grep -rl '/home/xxx/workspace/prod_venv' . | xargs sed -i 's#/home/xxx/workspace/prod_venv#/opt/flask_app/venv#g'

3. 打包整个虚拟环境目录，保留文件权限：

tar -zcpf venv_migrate.tar.gz ./prod_venv

目标嵌入式设备端操作步骤 #

1. 将打包好的venv_migrate.tar.gz传输到提前规划好的目标机父目录，即之前定的/opt/flask_app路径下
2. 解压并修复文件权限：

cd /opt/flask_app
tar -zxpf venv_migrate.tar.gz
# 将解压后的目录重命名为之前路径配置中使用的venv名称
mv prod_venv venv
# 给可执行文件添加执行权限
chmod +x ./venv/bin/*

3. 验证迁移结果，直接调用虚拟环境内的Python解释器执行测试命令，无需执行激活脚本：

/opt/flask_app/venv/bin/python -c "import flask; print('flask版本:', flask.__version__)"

命令正常输出版本号无报错即迁移成功，后续启动Flask服务时直接使用/opt/flask_app/venv/bin/python 你的服务启动文件.py即可，全程不需要在目标机执行任何pip操作。

避坑说明 #

• 虚拟环境迁移完成后不要随意更改存放目录，若必须调整路径，需要重新执行全量路径替换操作
• 若依赖包含C扩展的第三方包（如numpy、cryptography、pycryptodome等），必须严格满足前置的架构、C库版本匹配要求，否则会触发二进制文件执行错误
• 生产环境启动服务时优先使用虚拟环境内Python的绝对路径，不要依赖activate脚本配置环境变量，减少嵌入式设备上的环境变量异常问题

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