如何在Python中正确引入GLFW共享库？PyInstaller编译后报错

问题描述 #

在pyenv管理的Python 3.9.13环境中项目运行正常，但通过python -m PyInstaller main.spec编译为exe后执行报错。spec文件内容如下：

# -*- mode: python -*- 

block_cipher = None 


a = Analysis(['Scripts\\main.py'],
             pathex=['C:\\Users\\Bruker\\Documents\\System'],
             binaries=[],
             datas=[],
             hiddenimports=[],
             hookspath=[],
             runtime_hooks=[],
             excludes=[],
             win_no_prefer_redirects=False,
             win_private_assemblies=False,
             cipher=block_cipher)
pyz = PYZ(a.pure, a.zipped_data,
             cipher=block_cipher)
exe = EXE(pyz,
          a.scripts,
          a.binaries,
          Tree('Classes\\Database', prefix=''),
          Tree('Classes\\Simulator', prefix=''),
      Tree('Classes\\Simulator\\DataStorage', prefix=''),
    Tree('Classes\\Simulator\\Window, Camera and GUI', prefix=''),
          a.zipfiles,
          a.datas,
          name='system',
          debug=False,
          strip=False,
          upx=True,
          runtime_tmpdir=None,
          console=False, icon='res\\logo.ico')

排查与解决建议 #

• 补全隐式依赖：PyInstaller无法自动检测动态导入的模块，将报错中缺失的模块添加到hiddenimports列表，例如hiddenimports=['缺失模块名', '缺失模块子路径']。
• 修正资源路径解析：exe运行时工作目录与开发环境不同，可在代码中用sys._MEIPASS获取exe解压后的临时目录，确保Tree引入的资源能被正确访问；同时注意Window, Camera and GUI目录包含特殊字符，尝试给路径加引号或重命名目录。
• 禁用UPX压缩：UPX可能损坏二进制依赖，将upx=True改为upx=False重新编译测试。
• 启用调试输出：把debug=False改为debug=True、console=False改为console=True，重新编译后通过控制台查看详细错误日志，定位具体问题。
• 确认环境一致性：执行pyenv version检查当前激活环境，确保编译时使用的是pyenv管理的Python 3.9.13，避免误用到系统Python或其他版本。

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