不推荐直接复制整个venv文件夹,因其含硬编码绝对路径、平台二进制及abi信息,易引发fatal error in launcher等错误;可靠方式是分离python版本、显式依赖与平台约束后分步重建。

venv 文件夹**——它包含硬编码的绝对路径、平台相关二进制文件和 ABI 信息,极易在新机器上触发 Fatal error in launcher 或 bad interpreter: No such file or directory。
真正可靠、可复现的方式是「重建」而非「搬运」。关键在于:**分离 Python 解释器版本、显式依赖、平台约束三者,并分步还原**。
用 pip freeze > requirements.txt 导出前必须清理环境
很多人导出后在新机器上 pip install -r requirements.txt 失败,根本原因是 pip freeze 会混入:
• 全局安装的包(比如 pip、setuptools 自身)
• 开发依赖(pytest、black 等)
• 本地路径包(-e /path/to/mylib)
• 平台特定占位符(pkg-resources==0.0.0)
正确做法:
• 在干净的 venv 中激活后操作
• 先运行 pip install --no-deps -r requirements.in(如果有),再 pip freeze
• 手动删掉 pip、setuptools、wheel 等基础工具行(它们应由 Python 发行版自带)
• 对 Windows/macOS 包加环境标记,如 pywin32==305; platform_system=="Windows"
conda 环境必须用 conda env export,不能用 pip freeze
conda 和 venv 是两套机制:
• conda 管 Python 解释器、C 库、非 Python 包(如 ffmpeg)
• pip freeze 只能看到 Python 包,完全丢失 python=3.9.16、openssl=3.0.13 这类关键信息
导出时务必:
• 使用 conda env export > environment.yml
• 若只需显式安装的包(避免锁死 build 号),加 --from-history
• 检查生成的 environment.yml 是否含 pip: 块;新机器需 conda ≥ 4.6 才能识别
• 不要手动编辑 environment.yml 中的 prefix: 字段——它是导出时自动生成的,conda env create 会忽略它
跨机器迁移时 Python 版本和架构必须严格一致
哪怕只是小版本不同(如 3.11.8 → 3.11.9),也可能因 ABI 变更导致 numpy、torch 等 C 扩展崩溃。
验证方式:
• 源机器运行 python -c "import sys; print(sys.version)"
• 目标机器安装**完全相同版本**的 Python(推荐用 pyenv install 3.11.8 或 Ubuntu 官方 deadsnakes PPA)
• 架构必须匹配:x86_64 不能迁到 aarch64,反之亦然
• 如果用系统自带 Python(如 Ubuntu 的 /usr/bin/python3),确保两台机器的 Ubuntu 版本一致(22.04 vs 24.04 的 libssl 版本不同)
requirements.txt 是接口,不是契约;environment.yml 是快照,但只对 conda 生效;而 Python 解释器本身,才是所有依赖得以运行的地基——它最容易被忽略,也最不容出错。Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











