如何向离线macOS 10.12机器分发适配的Python readline包？

这个问题我之前帮不少开发者踩过坑——本质上是wheel包的平台兼容性标签在搞鬼。当你在macOS 10.13上用pip wheel构建readline包时，它会自动给wheel打上macosx_10_13_x86_64的标签，pip在10.12的机器上检查时，会认为这个包是为更高版本系统编译的，直接拒绝安装。

下面给你三个可行的解决方案，按推荐程度排序：

方案1：直接构建适配macOS 10.12的wheel（最稳妥） #

与其事后修改，不如在构建阶段就直接指定目标系统版本，这样生成的wheel天然兼容10.12：

• 在联网的macOS 10.13机器上执行以下命令：

  pip wheel -w . --platform macosx_10_12_x86_64 readline
  

• 生成的wheel文件名会是readline-6.2.4.1-cp36-cp36m-macosx_10_12_x86_64.whl，直接拿到无网络的10.12机器上，执行你原来的安装命令就能正常安装了：

  pip install --no-index --find-links . readline
  

方案2：修改已生成的10.13版wheel适配10.12 #

如果已经有了10.13的wheel，不想重新构建，可以手动修改它的兼容性标签：

1. 先修改wheel文件名，把macosx_10_13替换成macosx_10_12，得到：readline-6.2.4.1-cp36-cp36m-macosx_10_12_x86_64.whl
2. 只改文件名还不够，wheel内部的元数据也存了平台标签，需要进一步修改：
   • 将wheel文件改为zip格式：

     mv readline-6.2.4.1-cp36-cp36m-macosx_10_12_x86_64.whl readline.zip
     

   • 解压zip包：

     unzip readline.zip
     

   • 找到解压后的readline-6.2.4.1.dist-info/WHEEL文件，用文本编辑器打开，把里面的Tag: cp36-cp36m-macosx_10_13_x86_64改成Tag: cp36-cp36m-macosx_10_12_x86_64
   • 重新打包成wheel：

     zip -r readline-6.2.4.1-cp36-cp36m-macosx_10_12_x86_64.whl *
     

3. 把修改后的wheel传到10.12机器上执行安装命令即可。

方案3：强制pip忽略平台检查（不推荐） #

如果只是临时测试场景，可以让pip跳过平台兼容性验证，但这种方法可能会导致潜在的运行时兼容性问题，不建议在生产环境使用：

pip install --no-index --find-links . --platform macosx_10_12_x86_64 --only-binary :all: readline

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