使用Github Actions编译Windows平台QT应用出现编译错误求助

问题根因定位 #

从报错日志可确定两个核心触发原因：

1. Windows系统头文件和Qt头文件的宏冲突，以及头文件包含顺序错误，导致系统头文件语法解析失败
2. CI配置中调用的构建工具和Qt MinGW版本不匹配

修复步骤 #

1. 修正头文件包含规则 #

将mainwindow.cpp第1068行的windows.h引入逻辑调整如下：

• 所有Qt头文件必须放在windows.h之前引入
• 引入windows.h前添加两个宏定义避免冲突

// 所有Qt头文件放此处
#include <QMainWindow>
// ... 其他Qt头文件

// 引入Windows头文件前添加宏
#define NOMINMAX
#define WIN32_LEAN_AND_MEAN
#include <windows.h>

NOMINMAX用于屏蔽Windows头文件定义的min/max宏，避免和Qt的同名函数冲突；WIN32_LEAN_AND_MEAN用于减少冗余头文件引入，降低冲突概率。

2. 补全代码语法 #

根据报错提示检查mainwindow.cpp第751行起始的函数块，重点验证Windows专属的条件编译分支（如#ifdef _WIN32包裹的代码）是否有遗漏的右花括号、分号，CI环境的MinGW编译器比本地环境的语法检查更严格，会把本地可忽略的疏漏判定为编译错误。

3. 修正GitHub Actions配置 #

你当前配置直接调用make.exe不符合Qt MinGW版本的构建要求，需要改用配套的mingw32-make，并且提前配置好环境变量，修改后的配置如下：

steps:
  - uses: actions/checkout@v2
  - name: 安装Qt和MinGW
    run: |
      choco install qt5-default mingw --no-progress
  - name: 编译项目
    shell: cmd
    run: |
      set PATH=C:\Qt\5.15.2\mingw81_64\bin;C:\ProgramData\chocolatey\lib\mingw\tools\install\mingw64\bin;%PATH%
      qmake.exe ..
      mingw32-make.exe -j%NUMBER_OF_PROCESSORS%

调整说明：

• 将代码拉取步骤放到依赖安装之前，避免安装过程修改工作目录导致代码拉取异常
• 显式指定cmd作为执行shell，规避PowerShell的路径转义问题
• 提前配置PATH环境变量，保证编译器和Qt工具链版本匹配
• 用mingw32-make替代普通make，适配MinGW生成的Makefile格式

4. （可选）调整jurplel/install-qt-action配置 #

如果使用该action安装Qt，需要显式指定架构参数，开启自动配置环境变量的开关：

- name: 安装Qt
  uses: jurplel/install-qt-action@v2.5.3
  with:
    version: '5.15.2'
    host: 'windows'
    target: 'desktop'
    arch: 'win64_mingw81'
    set-env: 'true'

配置完成后后续编译步骤无需手动指定Qt路径，直接调用qmake和mingw32-make即可。

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