Manjaro Linux下VSCode配置QT6报错无法打开QMainWindow源文件

QMainWindow头文件飘红核心由三个问题导致：

• Qt6的头文件按模块拆分存放在不同子目录，VSCode C/C++扩展对系统级目录的递归扫描有深度限制，你配置的/usr/include/qt6/**不会扫描到二级、三级的模块头文件目录，IntelliSense无法定位头文件位置
• Qt6 最低要求C++17编译标准，你当前配置的c++14不符合版本依赖要求
• 原配置缺少Qt条件编译必须的预定义宏，且include路径最后一项存在多余尾逗号，会导致JSON配置解析失败

1. 确认本地Qt6安装路径 #

Manjaro下通过pacman安装qt6-base包后，在终端执行以下命令确认Qt6头文件根目录：

qmake6 -query QT_INSTALL_HEADERS

默认输出为/usr/include/qt6，如果输出路径不同，后续配置替换为实际输出路径即可。

2. 修正c_cpp_properties.json配置 #

将原有配置替换为以下内容，补全模块路径、修正C++版本、添加必要宏定义、修复JSON语法错误：

{
    "configurations": [
        {
            "name": "Linux",
            "includePath": [
                "${workspaceFolder}/**",
                "/usr/include/qt6",
                "/usr/include/qt6/QtCore",
                "/usr/include/qt6/QtGui",
                "/usr/include/qt6/QtWidgets"
            ],
            "defines": [
                "QT_CORE_LIB",
                "QT_GUI_LIB",
                "QT_WIDGETS_LIB"
            ],
            "compilerPath": "/usr/bin/g++",
            "cStandard": "c17",
            "cppStandard": "c++17",
            "intelliSenseMode": "linux-gcc-x64"
        }
    ],
    "version": 4
}

保存配置后重启VSCode，头文件找不到的飘红问题就会消失。如果后续用到其他Qt模块（比如QtNetwork、QtCharts），只需要在includePath里补充对应模块的头文件目录，同时在defines里添加QT_模块名大写_LIB格式的宏即可。

3. 编译配置说明 #

上述配置仅解决VSCode编辑器的代码提示飘红问题，实际编译不要直接调用g++单文件编译：

• 简易项目可以直接用qmake流程：项目根目录执行qmake6 -project生成.pro文件，在.pro文件内添加QT += widgets声明依赖的Qt模块，再依次执行qmake6生成Makefile、make完成编译
• 长期开发推荐在VSCode安装Qt Tools扩展，关联本地qmake6路径后可以自动识别项目配置，不需要手动维护include路径列表。

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