Linux下用MinGW交叉编译C语言GTK3+项目生成Windows可执行文件报错如何解决

当前编译命令失效的核心原因 #

你使用的编译命令默认调用宿主机（Linux/macOS）原生的pkg-config工具，获取的是本地系统GTK3的编译参数，完全和你安装的MinGW交叉编译工具链的环境不匹配，必然出现头文件路径找不到、链接库格式不兼容的报错。
原命令存在的具体问题：

• 未指定pkg-config读取交叉编译环境下的GTK3配置，直接引入了Linux原生的库路径，和交叉编译器的目标平台不兼容
• 输出文件未指定Windows可执行文件需要的.exe后缀，默认生成的目标格式无法在Windows运行
• 未安装MinGW版本的GTK3开发依赖，仅靠本地系统的GTK3库无法完成跨平台链接

前置环境配置流程 #

所有步骤适配Debian/Ubuntu类Linux环境，其他发行版可对应替换包管理命令：

• 安装x86_64目标平台的MinGW交叉编译工具链
  执行安装命令：sudo apt install gcc-mingw-w64-x86-64 mingw-w64-x86-64-dev
• 安装适配MinGW的GTK3交叉开发依赖包
  执行安装命令：sudo apt install libgtk-3-dev-mingw-w64-x86-64
  该包会自动把对应版本的GTK3头文件、动态链接库、pkg-config配置文件部署到交叉编译专属路径，不会和本地系统的库文件混淆。

修正后的可正常编译的命令 #

核心逻辑是让pkg-config精准匹配交叉编译环境的配置，避免路径错误：

# 指定pkg-config的搜索路径，定位到MinGW交叉环境的配置目录
export PKG_CONFIG_PATH=/usr/x86_64-w64-mingw32/lib/pkgconfig
# 执行编译生成Windows格式可执行文件
x86_64-w64-mingw32-gcc -g -o test.exe PROJECT_INTERFACE.c PROJECT.c `x86_64-w64-mingw32-pkg-config --cflags gtk+-3.0` `x86_64-w64-mingw32-pkg-config --libs gtk+-3.0`

调整点说明：

• 用带x86_64-w64-mingw32前缀的专属pkg-config工具替代系统原生pkg-config，确保获取的编译参数全部指向Windows平台MinGW环境下的路径，不会混入Linux原生目录
• 输出文件名添加.exe后缀，明确让编译器生成Windows可识别的PE格式可执行文件
• 通过环境变量指定pkg-config搜索路径，从根源上避免路径匹配错误

终端发布包制作流程 #

单独编译生成的test.exe无法直接在Windows上独立运行，需要配套打包所有依赖资源：

• 新建发布目录，将编译完成的test.exe拷贝至该目录
• 从MinGW的GTK3安装路径/usr/x86_64-w64-mingw32/bin中，拷贝MinGW运行时依赖（libgcc_s_seh-1.dll、libwinpthread-1.dll等）和所有GTK3相关动态链接库到发布目录
• 按照GTK3的标准运行时目录结构，在发布目录下新建etc、lib、share子目录，将交叉安装路径下的GTK3主题配置、pixbuf加载器、语言资源等对应文件拷贝到匹配的子目录中

  如果不想手动梳理依赖文件，可以直接使用GTK官方提供的Windows版GTK3运行时包，将运行时包解压到和exe同目录即可，无需逐个排查dll依赖。

常见报错排查 #

• 出现gtk/gtk.h: No such file or directory报错：检查交叉版本的GTK3开发包是否正常安装，PKG_CONFIG_PATH环境变量的路径是否正确
• 出现链接阶段提示找不到-lgtk-3类错误：检查是否误用了系统原生pkg-config获取编译参数，必须使用交叉版本的pkg-config工具
• 在Windows上运行exe提示缺失dll：对照打包步骤，将所有依赖动态库和资源目录完整拷贝到发布目录即可

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