PyInstaller打包后cairo.Context集成失败，无法识别python-gi-cairo包求助

原因分析 #

1. 导入名称错误：python-gi-cairo是Debian/Ubuntu系统包的名称，Python代码中实际导入的是gi.cairo，PyInstaller尝试查找的python-gi-cairo并非有效的Python模块名。
2. 系统级包扫描限制：python3-gi-cairo通过apt安装在系统级Python目录，PyInstaller默认优先扫描pip管理的包，可能无法自动识别到系统路径下的该模块。
3. 环境不一致：若使用虚拟环境运行PyInstaller，虚拟环境可能未关联系统级的gi模块，导致PyInstaller无法扫描到相关依赖。

解决思路 #

1. 指定正确的隐藏导入 #

打包时替换错误的隐藏导入名称，使用实际的模块名gi.cairo：

sudo pyinstaller App.py --onefile --hidden-import gi.cairo

2. 手动添加模块路径 #

如果PyInstaller仍找不到gi.cairo，先定位系统级gi模块的安装路径（通常在/usr/lib/python3/dist-packages），再通过--paths参数告知PyInstaller：

sudo pyinstaller App.py --onefile --hidden-import gi.cairo --paths /usr/lib/python3/dist-packages

3. 修改Spec文件强制添加依赖 #

生成Spec文件后，直接在其中指定隐藏导入：

1. 生成Spec文件：

   sudo pyinstaller App.py --onefile --specpath .
   

2. 编辑App.spec，在hiddenimports列表中添加'gi.cairo'：

   a = Analysis(
       ['App.py'],
       # ... 其他参数
       hiddenimports=['gi.cairo'],
       # ... 其他参数
   )
   

3. 用Spec文件重新打包：

   sudo pyinstaller App.spec
   

4. 收集所有GI相关依赖 #

使用--collect-all参数强制PyInstaller收集gi模块的所有文件，确保cairo相关组件被打包：

sudo pyinstaller App.py --onefile --collect-all gi --hidden-import gi.cairo

5. 验证环境一致性 #

• 确保运行PyInstaller的Python环境与运行源码的环境一致，若使用虚拟环境，需确认虚拟环境能正常导入gi.cairo：

  import gi
  gi.require_version('cairo', '1.0')
  from gi.repository import cairo
  

• 若虚拟环境无法访问系统级模块，可在创建虚拟环境时添加--system-site-packages参数，允许虚拟环境使用系统级依赖。

6. 目标机器依赖检查 #

若打包后的程序在目标机器仍报错，需确保目标机器安装了系统级依赖：

sudo apt install libcairo2 python3-gi python3-gi-cairo

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