如何在MacBook上为树莓派3生成正确标签的Python平台Wheel包？

这问题我之前处理过类似的场景，核心原因在于Python 2.7在ARM平台上的Unicode字符集（UCS）编译选项差异：cp27m对应UCS-2编码，而树莓派的Python 2.7通常是用UCS-4编译的，对应标签cp27mu。要让bdist_wheel直接生成正确标签的包，你可以通过自定义bdist_wheel命令来实现，具体步骤如下：

1. 修改setup.py，重写Wheel标签逻辑 #

在你的setup.py中添加一个自定义的bdist_wheel子类，替换掉默认的ABI标签：

from setuptools import setup
from wheel.bdist_wheel import bdist_wheel

class ARMv7Wheel(bdist_wheel):
    def get_tag(self):
        # 获取默认的标签三元组：(Python版本标签, ABI标签, 平台标签)
        py_tag, abi_tag, plat_tag = super().get_tag()
        # 针对armv7平台的Python 2.7，替换ABI标签为cp27mu
        if py_tag == "cp27" and plat_tag == "linux_armv7l":
            abi_tag = "cp27mu"
        return (py_tag, abi_tag, plat_tag)

# 原有setup配置不变，添加cmdclass指定自定义的bdist_wheel命令
setup(
    name="mypackage",
    version="0.1.17",
    # 你的其他配置：ext_modules、packages等
    cmdclass={"bdist_wheel": ARMv7Wheel},
)

2. 重新构建Wheel包 #

执行原来的构建命令：

python setup.py bdist_wheel --plat-name linux-armv7l

此时dist目录下生成的Wheel文件名就会是<mypackage>-0.1.17-cp27-cp27mu-linux_armv7l.whl，直接传到树莓派就能正常安装，无需手动重命名。

补充说明 #

为什么会出现这个标签差异？

• Python 2.7编译时可以选择UCS-2或UCS-4作为Unicode内部编码：
  • UCS-2（每个字符占2字节）对应ABI标签cp27m，常见于x86平台的Python 2
  • UCS-4（每个字符占4字节）对应ABI标签cp27mu，树莓派等ARM平台的官方Python 2通常采用这种配置
• Wheel包的ABI标签不匹配时，pip会认为包与当前环境不兼容，拒绝安装，所以必须确保标签对应正确的UCS版本。

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