一、什么是manylinux_2_17_x86_64？
manylinux_2_17_x86_64是Python生态中用于标识Linux平台二进制兼容性的标准标签，其核心目标是确保编译生成的Python扩展包（如.whl文件）能够在多种Linux发行版上运行。它的命名规则与底层系统库版本密切相关：
-
核心依赖
manylinux_2_17对应的是glibc 2.17的最低兼容要求。这意味着使用该标签的二进制包，必须兼容基于glibc 2.17及以上版本的Linux系统（例如CentOS 7、Ubuntu 16.04等）。 -
应用场景
当开发者通过auditwheel工具打包Python扩展时，若系统依赖库版本未超出glibc 2.17的支持范围，生成的包会被标记为manylinux_2_17_x86_64。这类包可兼容绝大多数主流Linux发行版，避免用户因环境差异导致安装失败。 -
与旧标准的区别
相比早期manylinux1（基于glibc 2.5）和manylinux2010（glibc 2.12），manylinux_2_17支持更高版本的系统库，同时通过动态链接库的向下兼容性保障跨发行版运行能力。
二、为何需要升级到manylinux_2_28_x86_64？
随着Linux系统库的更新，若Python扩展依赖更高版本的库（例如glibc 2.28），原有的manylinux_2_17标签将无法满足需求。典型的升级场景包括：
- 需要支持新硬件特性（如AVX-512指令集）
- 依赖新版系统库功能（如OpenSSL 3.0）
- 兼容基于glibc 2.28的系统（如Ubuntu 20.04、CentOS 8 Stream等）
三、升级到manylinux_2_28_x86_64的步骤
步骤1：升级系统基础库
升级的核心是更新glibc到2.28版本。以下是关键操作流程（以CentOS为例）：
-
安装依赖工具链
yum install -y bison make gcc -
编译安装gcc 8.2
glibc 2.28要求编译器支持C11标准，需升级gcc：tar xf gcc-8.2.0.tar.gz cd gcc-8.2.0 ./contrib/download_prerequisites # 下载依赖库 mkdir build && cd build ../configure --prefix=/usr/local/gcc-8.2.0 --enable-languages=c,c++ make -j8 && make install export PATH=/usr/local/gcc-8.2.0/bin:$PATH # 更新环境变量 -
编译安装glibc 2.28
tar xf glibc-2.28.tar.gz mkdir build && cd build ../configure --prefix=/usr --disable-profile --enable-add-ons make -j8 && make install strings /lib64/libc.so.6 | grep GLIBC # 验证版本
步骤2：构建Python扩展包
在升级系统库后，需通过工具链生成符合新标准的包：
# 使用auditwheel重新打包
auditwheel repair --plat manylinux_2_28_x86_64 your_package.whl# 检查输出标签
unzip -l repaired_package.whl | grep manylinux
步骤3：验证兼容性
通过Docker容器测试兼容性：
docker run --rm -v $(pwd):/data quay.io/pypa/manylinux_2_28_x86_64 \/bin/bash -c "pip install /data/repaired_package.whl && pytest"
四、注意事项
- 系统稳定性
glibc是Linux核心库，升级后需全面测试系统服务（如网络、文件操作）的兼容性。 - 依赖链管理
若使用Conda或虚拟环境，需确保所有依赖库（如GDAL、OpenCV）同步升级至支持glibc 2.28的版本。 - 多平台兼容性
若需同时支持旧系统，可采用分发包策略，为不同manylinux标准生成多个.whl文件。
通过上述步骤，开发者既能利用新系统库的特性，又能确保Python扩展包在广泛Linux环境中的兼容性。如需更详细的构建脚本示例，可参考GDAL多平台编译实践。
