如何将Python虚拟环境venv迁移至离线计算机

方案1：直接打包venv目录（同系统同架构首选） #

• 适用场景：本地机器和目标离线机器的操作系统、CPU架构、Python大版本（如均为3.9.x）完全一致
• 操作步骤：
  1. 本地执行deactivate退出当前虚拟环境
  2. 将完整的venv文件夹打包为压缩包（支持zip、tar.gz等任意格式）
  3. 将压缩包传输到离线机器后解压到任意路径
  4. 若解压路径和本地原venv路径不一致，需修改激活脚本中的路径配置：
     • Linux/macOS：修改venv/bin/activate中的VIRTUAL_ENV变量为当前venv的绝对路径
     • Windows：修改venv/Scripts/activate.bat和venv/Scripts/Activate.ps1中的虚拟环境路径配置
  5. 执行激活脚本后运行pip list校验依赖是否完整

方案2：导出依赖+离线批量安装（兼容性最高，跨平台可用） #

• 适用场景：两台机器系统/架构存在差异，或直接打包venv无法正常运行的场景
• 操作步骤：
  1. 本地激活venv后执行pip freeze > requirements.txt导出精确版本的依赖清单
  2. 本地执行pip download -d ./pip_packages -r requirements.txt将所有依赖的安装包（含whl二进制包、源码包）下载到pip_packages目录
  3. 将requirements.txt和pip_packages目录一并传输到离线机器
  4. 离线机器先安装和本地版本完全一致的Python基础环境，创建并激活新的空虚拟环境
  5. 执行pip install --no-index --find-links=./pip_packages -r requirements.txt完成所有依赖的离线安装
  6. 安装完成后执行pip list对比依赖版本和本地是否一致

方案3：基于包管理工具迁移（适配Pipenv/Poetry用户） #

• 适用场景：本地项目已使用Pipenv、Poetry等现代包管理工具做依赖管控的场景
• 操作步骤：
  1. 本地执行对应工具的依赖导出命令，例如Poetry用户执行poetry export -f requirements.txt --output requirements.txt --without-hashes导出依赖清单
  2. 参考方案2的步骤下载所有对应平台的依赖安装包
  3. 离线机器安装对应包管理工具后，指定本地包源完成依赖安装即可

• 跨操作系统（如Windows→Linux/macOS）、跨CPU架构（如x86→ARM）的场景禁止使用直接打包venv的方案，必须通过导出依赖+下载对应平台安装包的方式迁移
• 优先保证两台机器的Python大版本完全一致，例如本地使用Python3.10则目标机器不要使用Python3.8，避免出现依赖兼容性问题
• 下载依赖包时优先选择对应平台的whl格式二进制包，避免源码包在离线机器上编译时缺少C编译器、系统依赖库等环境导致安装失败
• 直接打包venv前必须先退出虚拟环境，避免激活状态下的临时文件被打包导致后续运行异常
• 若依赖包含需系统级动态库支持的包（如OpenCV、PyTorch、TensorFlow），需提前确认离线机器已安装对应版本的系统依赖，比如CUDA、cuDNN版本要和PyTorch版本匹配，否则依赖安装成功也无法正常运行
• 迁移完成后先执行pip list对比依赖版本和本地是否完全一致，再运行项目核心测试用例验证功能可用性

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