使用manylinux构建wheel包数量及相关选型问题咨询

问题1：如何选择合适的manylinux OS镜像？ #

可以从兼容性和功能需求两个核心维度判断：

• 兼容性优先：如果项目需要兼容尽可能多的旧版Linux发行版（比如CentOS 7、Ubuntu 18.04这类仍有大量用户的系统），优先选版本较老的manylinux镜像，比如manylinux_2_17（对应CentOS 7）。这类镜像基于老系统构建，依赖的底层库版本低，能适配更多旧环境。
• 功能优先：如果项目依赖较新的系统库特性（比如新版GCC、glibc提供的功能），或者需要使用容器内的新工具链，就选较新的manylinux镜像，比如manylinux_2_28（对应CentOS 8）。这类镜像支持更多现代功能，但兼容的旧发行版会少一些。
• 参考用户分布：如果能统计到项目用户的系统环境（比如通过Issue、用户调研），可以直接匹配用户占比最高的发行版对应的manylinux版本，精准适配核心用户。
  另外，所有符合manylinux标准的镜像都能被PyPI接受，不用顾虑上传问题。

问题2：上传PyPI需要为x86_64以外的架构生成wheel吗？ #

没有强制要求，完全看你的用户群体：

• 如果用户绝大多数都是x86_64架构（比如普通PC、大部分云服务器），只传x86_64的wheel完全够用。
• 如果有不少用户使用arm64（比如M系列Mac、国产服务器、嵌入式设备）、ppc64le等架构，建议补充对应架构的wheel——这类用户如果没有预编译wheel，就得从源码编译，不仅耗时还容易因环境问题失败，体验很差。
  现在很多CI工具都支持多架构构建，成本不高的话，多做几个主流架构的wheel能覆盖更多用户。

问题3：需要为所有Python版本生成wheel吗？ #

不用为每个小版本都做，但要覆盖你项目声明支持的所有Python大版本：

• Python的C扩展ABI按大版本区分（比如cp38、cp39、cp310），同一个大版本内的小版本（比如3.8.1和3.8.10）是兼容的，所以只需要为每个大版本生成一份wheel即可。
• 不能只生成最低支持版本的wheel，因为不同大版本的Python ABI不兼容，比如cp38的wheel无法在cp39环境下安装。
• 如果你的项目是纯Python项目，其实不需要用manylinux，直接上传universal wheel就能适配所有支持的Python版本。

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