如何在MSYS2的MinGW环境下解决dbusmessage.h编译错误

API 探路者

2026-7-26

问题描述

在Linux平台开发的gtkmm程序编译正常，迁移到Windows 10通过MSYS2环境（g++ 12.2.0，gtkmm 4.0）编译时，触发giomm库dbusmessage.h的编译错误，核心错误为ERROR枚举与系统宏冲突，编译命令及错误信息如下：

$ g++ main.cpp source/ControlWidget.cpp source/ControlWidget.h source/LaneWidget.cpp source/LaneWidget.h source/NameDialogue.cpp source/NameDialogue.h source/mainwindow.cpp source/mainwindow.h source/rs232.c source/rs232.h $(pkg-config --cflags --libs gtkmm-4.0) -o test.exe
In file included from C:/msys64/mingw64/include/windows.h:71,
                 from source/rs232.h:56,
                 from source/ControlWidget.h:14,
                 from source/mainwindow.h:14,
                 from main.cpp:1:
C:/msys64/clang64/include/giomm-2.68/giomm/dbusmessage.h:90:3: error: expected identifier before numeric constant
   90 |   ERROR,
      |   ^~~~~
C:/msys64/clang64/include/giomm-2.68/giomm/dbusmessage.h:90:3: error: expected '}' before numeric constant
In file included from C:/msys64/clang64/include/giomm-2.68/giomm/dbusmethodinvocation.h:26,
                 from C:/msys64/clang64/include/giomm-2.68/giomm/dbusconnection.h:29,
                 from C:/msys64/clang64/include/giomm-2.68/giomm/application.h:37,
                 from C:/msys64/clang64/include/gtkmm-4.0/gtkmm/application.h:32,
                 from main.cpp:2:
C:/msys64/clang64/include/giomm-2.68/giomm/dbusmessage.h:86:1: note: to match this '{'
   86 | {
      | ^
C:/msys64/clang64/include/giomm-2.68/giomm/dbusmessage.h:90:3: error: expected unqualified-id before numeric constant
   90 |   ERROR,
      |   ^~~~~
C:/msys64/clang64/include/giomm-2.68/giomm/dbusmessage.h:279:1: error: expected declaration before '}' token
  279 | } // namespace Gio
      | ^
C:/msys64/clang64/include/giomm-2.68/giomm/dbusmessage.h:286:34: error: 'CapabilityFlags' is not a member of 'Gio::DBus'; did you mean 'Gio::CapabilityFlags'?
  286 | class GIOMM_API Value<Gio::DBus::CapabilityFlags> : public Glib::Value_Flags<Gio::DBus::CapabilityFlags>
      |                                  ^~~~~~~~~~~~~~~
C:/msys64/clang64/include/giomm-2.68/giomm/dbusmessage.h:242:12: note: 'Gio::CapabilityFlags' declared here
  242 | enum class CapabilityFlags
      |            ^~~~~~~~~~~~~~~
C:/msys64/clang64/include/giomm-2.68/giomm/dbusmessage.h:286:49: error: template argument 1 is invalid
  286 | class GIOMM_API Value<Gio::DBus::CapabilityFlags> : public Glib::Value_Flags<Gio::DBus::CapabilityFlags>
      |                                                 ^
C:/msys64/clang64/include/giomm-2.68/giomm/dbusmessage.h:286:89: error: 'CapabilityFlags' is not a member of 'Gio::DBus'; did you mean 'Gio::CapabilityFlags'?
  286 | class GIOMM_API Value<Gio::DBus::CapabilityFlags> : public Glib::Value_Flags<Gio::DBus::CapabilityFlags>
      |                                                                                         ^~~~~~~~~~~~~~~
C:/msys64/clang64/include/giomm-2.68/giomm/dbusmessage.h:242:12: note: 'Gio::CapabilityFlags' declared here
  242 | enum class CapabilityFlags
      |            ^~~~~~~~~~~~~~~
C:/msys64/clang64/include/giomm-2.68/giomm/dbusmessage.h:286:104: error: template argument 1 is invalid
  286 | class GIOMM_API Value<Gio::DBus::CapabilityFlags> : public Glib::Value_Flags<Gio::DBus::CapabilityFlags>
      |                                                                                                         ^

已确认所有MSYS2包为最新版本，寻求解决方案。

解决方案

1. 根本原因

Windows系统头文件windows.h中定义了#define ERROR 0宏，与giomm的dbusmessage.h里的ERROR枚举值命名冲突，导致编译解析失败。同时当前混用了mingw64和clang64环境的头文件，进一步加剧问题。

2. 具体修复步骤

步骤一：统一MSYS2环境

确保编译环境与依赖库来自同一MSYS2子系统：

若使用mingw64终端，安装mingw64版本的gtkmm4：
```
pacman -S mingw-w64-x86_64-gtkmm4
```
若使用clang64终端，安装clang64版本的gtkmm4：
```
pacman -S mingw-w64-clang-x86_64-gtkmm4
```

编译时保持终端环境与库版本一致，避免跨环境引用头文件。

步骤二：解决宏冲突

有两种方案可选：

方案A：调整头文件包含顺序

将gtkmm/giomm相关头文件优先于依赖windows.h的本地头文件包含。例如修改main.cpp的头文件顺序：

// 先包含gtkmm核心头文件
#include <gtkmm/application.h>
// 再包含依赖windows.h的本地头文件
#include "source/mainwindow.h"

编译器会先解析giomm的ERROR枚举，后续windows.h的宏定义不会影响已解析的代码。

方案B：禁用冲突宏

在包含windows.h前定义WIN32_LEAN_AND_MEAN和NOMINMAX，并取消ERROR宏定义。修改rs232.h：

#define WIN32_LEAN_AND_MEAN  // 减少windows.h导出的冗余符号
#define NOMINMAX             // 禁用min/max宏，避免其他潜在冲突
#include <windows.h>
#undef ERROR                 // 取消ERROR宏定义，让giomm的枚举正常解析

此方案无需调整头文件顺序，直接消除宏冲突。

3. 验证修复

修改后重新执行编译命令（无需在命令行中包含头文件，编译器会通过源文件的include自动处理）：

g++ main.cpp source/*.cpp $(pkg-config --cflags --libs gtkmm-4.0) -o test.exe

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