解决PyInstaller打包时struct.error: unpack requires a buffer of 4 bytes错误

错误原因 #

• 你使用--add-binary参数将整个site-packages目录添加到打包内容中，该目录包含大量非Mach-O二进制文件（如Python源码文件、文本配置、资源文件等）。PyInstaller在处理--add-binary指定的文件时，会调用macholib检查文件的Mach-O架构，但非二进制文件无法提供符合要求的4字节头部数据，导致struct.unpack操作失败。
• 额外说明：Mac系统下PyInstaller默认生成的是Mach-O格式的可执行文件或.app包，无法直接生成Windows平台的.exe文件。

解决方法 #

• 移除不必要的目录添加：PyInstaller会自动分析并收集Python脚本依赖的所有包和模块，无需手动添加整个site-packages。简化命令为：

  pyinstaller main.py --onefile --windowed
  

• 按需添加二进制文件：如果确实需要打包特定的二进制文件（如.dylib、.so），仅指定单个文件或特定子目录，而非整个site-packages：

  pyinstaller main.py --onefile --windowed --add-binary="/path/to/required/binary.dylib:lib"
  

• 正确使用--add-data处理非二进制资源：如果要添加的是普通资源文件（如文本、图片、配置文件），使用--add-data参数而非--add-binary，示例：

  pyinstaller main.py --onefile --windowed --add-data="/path/to/resource.txt:."
  

• 清理缓存重新打包：删除当前目录下的build、dist文件夹和main.spec文件，再重新执行打包命令，避免缓存文件损坏引发的异常。
• 升级依赖库：将PyInstaller和macholib更新到最新版本，修复可能存在的旧版bug：

  pip install --upgrade pyinstaller macholib
  

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