Pyinstaller打包的wxPython程序在旧版OS X运行失败

这个报错的核心原因很明确：你在OS X 10.13.4（High Sierra）上打包程序时，Python依赖库中引入了_futimens这个系统符号——而这个符号是从OS X 10.13才开始加入的，10.12.6（Sierra）系统根本没有这个API，所以运行时会触发符号找不到的错误。

下面是几个可行的解决方案，按推荐程度排序：

1. 在目标系统（10.12.6）上重新打包 #

这是最稳妥的方案，因为PyInstaller会直接打包当前系统的Python运行时和依赖库，完全匹配目标系统的API支持。如果没有现成的10.12.6机器，可以用虚拟机（比如Parallels、VirtualBox）搭建一个该版本的系统环境，然后依次完成：

• 安装兼容10.12.6的Python版本（比如Python 3.6~3.8，避免用3.9+，因为高版本Python不再支持10.12）
• 安装对应版本的wxPython（推荐wxPython 4.0.x系列，确保兼容10.12）
• 安装PyInstaller，然后重新打包你的GUI程序

2. 在10.13.4上设置部署目标后打包 #

如果必须在当前的10.13.4环境打包，可以通过设置MACOSX_DEPLOYMENT_TARGET环境变量，强制编译器生成兼容10.12的二进制文件：

• 打开终端，先设置环境变量：

  export MACOSX_DEPLOYMENT_TARGET=10.12
  

• 重新安装Python（如果是通过brew或源码安装的，确保Python是基于10.12目标编译的）
• 重新安装wxPython和PyInstaller，确保这些依赖也是基于10.12目标编译的
• 最后用PyInstaller打包，建议加上--clean参数清理缓存：

  pyinstaller --clean your_wxpython_script.py
  

3. 检查并调整PyInstaller打包参数 #

有时候缓存的旧依赖会导致问题，除了--clean参数，还可以指定bundle标识符，确保打包过程生成干净的依赖：

pyinstaller --clean --osx-bundle-identifier com.your.app.name your_script.py

另外，避免使用--onefile参数（如果之前用了的话），单文件模式可能会引入更多系统依赖问题，先试试文件夹模式（默认）打包测试。

4. 手动替换缺失符号（进阶） #

如果上面的方法都无效，你可以尝试手动修改打包后的Python库文件，把_futimens替换为10.12支持的替代函数（比如utimensat），或者自己实现一个兼容的版本。不过这个方法需要一定的二进制逆向知识，比如使用otool查看符号依赖，用install_name_tool或dyld工具修改，只推荐有经验的开发者尝试。

额外注意点 #

• 确保所有依赖库（Python、wxPython、PyInstaller）的版本都兼容OS X 10.12.6，避免使用只支持高版本系统的库
• 打包完成后，在10.12.6系统上从命令行运行，观察是否有其他缺失的符号，逐个解决依赖问题

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