如何为多平台构建pip包？含跨平台编译与manylinux标签疑问

一、单机器生成Linux、macOS多平台wheel包的方法 #

1. 容器化构建（Docker） #

• Linux多版本适配：直接用官方的manylinux镜像（比如quay.io/pypa/manylinux1_x86_64），在Docker容器里完成构建流程，生成的wheel天然符合manylinux标准，兼容更广范围的Linux发行版。
• macOS版本构建：如果你的单机器是Linux，要么用支持macOS模拟的容器镜像（注意这类镜像可能涉及版权问题），要么本地搭个macOS虚拟机（比如用QEMU），在虚拟机里走macOS的构建流程。要是你的单机器本身是macOS，直接用Docker跑manylinux容器就能生成Linux版本的wheel。

2. 用cibuildwheel工具一键构建 #

这是专门做多平台wheel的工具，上手简单：

• 先安装：pip install cibuildwheel
• 在项目根目录写个pyproject.toml配置文件，指定要构建的平台：

[tool.cibuildwheel]
platforms = ["linux_x86_64", "macos_x86_64"]

• 执行命令：cibuildwheel --output-dir wheelhouse，工具会自动拉取对应容器镜像（Linux）或本地构建（macOS），直接生成各平台的wheel包。

3. 交叉编译（适合Linux多版本/架构） #

如果项目支持交叉编译，可以配置编译链针对目标平台的glibc版本进行编译，生成兼容的共享库和Python绑定。不过这种方法需要手动处理依赖和编译环境，复杂度偏高，适合有一定编译经验的场景。

二、manylinux1_x86_64标签的兼容性 #

manylinux1_x86_64是符合PEP 513标准的标签，要求编译时依赖的glibc版本不高于2.5，以此保证兼容所有glibc版本≥2.5的x86_64 Linux发行版。

• 绝大多数主流x86_64 Linux发行版，比如Ubuntu 12.04及以后、Fedora 9及以后、所有版本的Kali Linux，都满足glibc≥2.5的要求，所以这些系统都能直接安装使用这个包。
• 只有极少数超老旧的发行版（比如CentOS 4及更早），因为glibc版本低于2.5，才无法使用该包。

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