如何借助独立构建机将pip构建的Python包迁移至生产机？

步骤1：在构建机上编译生成wheel包 #

直接用pip的wheel命令，把目标包及其依赖编译成可移植的wheel格式，存到指定目录：

python -m pip wheel --wheel-dir ./local_wheels example-package

执行完成后，local_wheels目录会包含example-package本身以及所有依赖的预编译wheel文件。

步骤2：将wheel包目录复制到生产机 #

用scp或rsync工具把整个local_wheels目录传到生产机的任意路径，比如：

scp -r ./local_wheels 生产机用户名@生产机IP:/opt/python_wheels/

步骤3：在生产机上从本地wheel安装包 #

在生产机执行pip安装命令，指定使用本地wheel文件，跳过PyPI索引和构建流程：

python -m pip install --no-index --find-links=/opt/python_wheels/ example-package

--no-index禁止pip从PyPI拉取包，--find-links指定本地wheel文件的存放路径，这样pip会直接用预编译好的文件完成安装，不需要任何构建依赖。

注意事项 #

• 两台主机架构一致、PyPy版本完全相同，所以构建的wheel包可以直接兼容，无需额外处理。
• 如果example-package依赖系统级库（非Python包），生产机仍需安装这些基础系统依赖，但这不属于构建依赖范畴，需单独确认。

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