Python3.4 Gtk程序用cx_Freeze打包exe报错：Namespace Gtk not available

我之前帮朋友处理过几乎一模一样的问题——用Python 3.4 + gi.repository调用Gtk 3.0，cx_Freeze打包后exe闪退，报Gtk命名空间不可用。核心问题是cx_Freeze没法自动识别gi这种动态加载的库依赖，得手动把Gtk运行时的关键文件都打包进去。下面是我亲测有效的步骤：

1. 修复setup.py，强制包含GI和Gtk相关模块 #

cx_Freeze默认不会扫描gi的动态依赖，所以得在setup.py里明确指定要包含的模块和文件。这里给你一个可直接修改使用的setup.py模板：

import sys
import os
from cx_Freeze import setup, Executable

# 基础路径配置，根据你的Python安装位置调整
python_root = sys.exec_prefix
gi_source_dir = os.path.join(python_root, "Lib", "site-packages", "gi")
gi_typelib_dir = os.path.join(python_root, "Lib", "site-packages", "lib", "girepository-1.0")
gtk_dll_dir = os.path.join(python_root, "Scripts")  # 大部分GTK DLL会在这里

# 要打包的文件列表：复制GI库、typelib文件和关键DLL
include_files = [
    # 把整个gi目录复制到exe的Lib子目录下
    (gi_source_dir, "Lib/gi"),
    # 复制Gtk的typelib文件，这是加载Gtk命名空间的关键
    (gi_typelib_dir, "lib/girepository-1.0"),
]

# 添加GTK运行必需的DLL（如果你的DLL在其他目录，改gtk_dll_dir就行）
required_dlls = [
    "libgtk-3-0.dll", "libgobject-2.0-0.dll", "libglib-2.0-0.dll",
    "libgdk-3-0.dll", "libcairo-2.dll", "libpango-1.0-0.dll"
]
for dll in required_dlls:
    dll_path = os.path.join(gtk_dll_dir, dll)
    if os.path.exists(dll_path):
        include_files.append((dll_path, dll))

# cx_Freeze构建选项
build_options = {
    "includes": ["gi", "gi._gi", "gi._gi_cairo", "gi.repository.Gtk"],
    "packages": ["gi"],
    "include_files": include_files,
    "path": sys.path + [gi_source_dir],
}

# GUI程序要设置base为Win32GUI，避免弹出控制台窗口
base = "Win32GUI" if sys.platform == "win32" else None

executables = [Executable("你的主脚本名.py", base=base)]

setup(
    name="你的应用名称",
    version="1.0",
    description="应用描述",
    options={"build_exe": build_options},
    executables=executables
)

2. 打包后验证关键文件是否存在 #

运行python setup.py build打包后，进入build/exe.win-xxx-3.4目录，检查以下内容：

• 有没有Lib/gi目录，里面要包含_gi.pyd、repository等子目录
• 有没有lib/girepository-1.0目录，里面要有Gtk-3.0.typelib文件
• 根目录下有没有之前指定的那些DLL文件

3. 调试闪退问题：用命令行运行exe #

如果还是闪退，别双击，打开命令提示符，cd到exe所在目录，直接运行你的程序.exe，这样就能看到完整的错误信息，方便定位遗漏的文件。比如如果提示缺少某个DLL，就找到它添加到include_files里。

4. 额外注意事项 #

• 确保你的Python环境里正确安装了pygi和GTK运行时：如果是用pip装的pygi，通常会自带基础的GTK文件；如果不行，建议从GTK官网下载Windows版的GTK 3，然后把它的bin目录加到系统PATH里。
• 用对应版本的cx_Freeze：Python 3.4比较老，建议用cx_Freeze 5.1.1这个版本（新版本已经不支持3.4了），可以用pip install cx_Freeze==5.1.1安装。
• 代码里可以手动设置GI_TYPELIB_PATH：在主脚本开头添加以下代码，确保程序能找到typelib文件：

  import os
  if hasattr(sys, 'frozen'):
      # 打包后的环境
      typelib_path = os.path.join(os.path.dirname(sys.executable), 'lib', 'girepository-1.0')
      os.environ['GI_TYPELIB_PATH'] = typelib_path
  

按照这些步骤来，应该能解决你的问题——我当时就是这么帮朋友搞定的，打包后的exe完全正常运行。

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