pip download + requirements.txt 是最稳的通用离线部署方案,前提是两台机器Python大版本一致、操作系统类型和架构匹配,全程仅搬运预编译.whl文件,不依赖源码编译。

pip download + requirements.txt 是最稳的通用方案
只要两台机器 Python 大版本一致(比如都是 3.9 或 3.11)、操作系统类型和架构匹配(如都是 Windows x64 或都是 Linux aarch64),这个流程就能跑通。核心是不依赖源码编译,只搬运预编译的 .whl 文件。
操作分三步:先导出依赖清单,再批量下载离线包,最后在目标机安装。
- 在有网机器上,进入项目目录,运行
pip freeze > requirements.txt;若只需特定库,可手动编辑requirements.txt,每行写requests==2.31.0这类精确版本 - 运行
pip download -r requirements.txt -d ./packages --no-deps(加--no-deps可避免拉取间接依赖,适合已知环境干净时);推荐加国内源提速:pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple - 把
requirements.txt和整个packages/文件夹拷到目标机同一目录下,执行pip install --no-index --find-links=./packages -r requirements.txt
conda-pack 更适合 Anaconda/Miniconda 用户
如果你用的是 conda 环境(尤其含 C 扩展、Fortran 编译模块如 numpy、scipy),conda-pack 比 pip 方案更可靠——它打包的是整个虚拟环境的二进制快照,连 bin/ 下的可执行脚本、share/ 里的数据文件都一并带走。
注意:目标机必须装有同版本 conda,且不能跨平台(Windows 打包的包不能直接解压到 Linux)。
- 在源机激活环境:
conda activate myenv - 安装打包工具:
conda install conda-pack - 执行打包:
conda pack -n myenv -o myenv.tar.gz;加--ignore-editable-packages可跳过开发模式安装的包 - 在目标机解压到
anaconda3/envs/下对应子目录,然后运行source myenv/bin/activate(Linux/macOS)或myenv\Scripts\activate.bat(Windows)
直接复制 site-packages 的坑最多
有人图省事,直接把源机 site-packages/ 整个文件夹拷过去,再 pip install --force-reinstall 覆盖——这几乎一定会失败。
原因很实在:路径硬编码、ABI 不兼容、C 扩展的 so/dll 文件无法跨系统加载、甚至某些包在安装时会写入注册表(Windows)或生成缓存路径(如 ~/.cache/pip)。
- 哪怕同是 Linux x86_64,glibc 版本差异也会让
numpy或torch报GLIBC_2.34 not found - Windows 上复制的
.pyd文件,在另一台机器可能因 VC++ 运行时缺失而 import 失败 -
pip install --force-reinstall不会重新编译,只是覆盖 Python 源码,对二进制部分无效
wheel 文件名里藏着关键兼容信息
一个典型的 wheel 名:requests-2.31.0-py3-none-any.whl 或 torch-2.3.0+cpu-cp39-cp39-win_amd64.whl。最后一段就是你的命门。
迁移前务必检查目标机的 python -c "import platform; print(platform.machine())" 和 python -c "import sys; print(sys.version_info[:2])",确保与 wheel 名中 cp39(Python 3.9)、win_amd64(Windows 64 位)等字段严格匹配。
-
any表示纯 Python 包,跨平台安全;win_amd64、manylinux_x86_64、macosx_12_0_arm64都是锁死的 - 如果
pip download拉下来的全是none-any,说明你没装编译工具链,或包本身没提供预编译版——这时得切回源码安装,但离线环境下风险陡增 - 遇到
ERROR: requests-2.31.0-py3-none-any.whl is not a supported wheel on this platform,八成是 wheel 名和当前 Python 不匹配,别硬装
实际迁移时最容易被忽略的,是 Python 解释器本身的 ABI 兼容性。比如在一台用 pyenv 编译的 Python 3.11.9 上装了 psycopg2,换到系统自带的 3.11.9 就可能因 OpenSSL 版本不同而报错——这种细节不会出现在 requirements.txt 里,只能靠测试验证。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











