现象描述

使用 Visual Studio Code（VSCode）进行 Qt 开发时，遇到 IntelliSense 无法识别 Qt 头文件的情况。

cannot open source file "QCoreApplication"
cannot open source file "QDebug"
Please update your includePath

问题定位

VSCode 的 C/C++ 扩展未正确配置头文件搜索路径（includePath）或编译器路径（compilerPath）

根因分析

VSCode 的 IntelliSense 是独立于构建系统的语义分析引擎。

它依赖 c_cpp_properties.json 中的手动或自动生成的配置来解析符号和头文件。

VSCode 的 C/C++ 扩展通过以下 JSON 文件管理语言服务器行为：

• c_cpp_properties.json：定义编译器路径、标准版本、包含路径等

• tasks.json：配置构建任务（如调用 qmake 或 cmake）

• launch.json：调试器配置

• CMakeLists.txt 或 .pro 文件：项目构建逻辑本身

其中，c_cpp_properties.json 是 IntelliSense 正常工作的关键。

解决方案

手动配置 c_cpp_properties.json：确保 includePath 包含 Qt 核心模块路径，如 .../include、.../include/QtCore、.../include/QtWidgets 等。

指定正确的 compilerPath：必须与构建所用编译器一致（例如 MSVC 的 cl.exe 或 MinGW 的 g++.exe）。

按 Ctrl + Shift + P → 输入：

C/C++: Edit Configurations (JSON)

覆盖（路径要填自己的Qt核心模块路径）

{
  "configurations": [
    {
      "name": "Win32",
      "includePath": [
        "${workspaceFolder}/**",

        "D:/Qt/5.15.2/mingw81_64/include",					  // ⭐
        "D:/Qt/5.15.2/mingw81_64/include/QtCore",			  // ⭐
        "D:/Qt/5.15.2/mingw81_64/include/QtGui",			  // ⭐
        "D:/Qt/5.15.2/mingw81_64/include/QtWidgets"           // ⭐
      ],
      "defines": [
        "UNICODE",
        "_UNICODE"
      ],
      "compilerPath": "D:/Qt/Tools/mingw810_64/bin/g++.exe",  // ⭐
      "cStandard": "c11",
      "cppStandard": "c++17",
      "intelliSenseMode": "windows-gcc-x64"
    }
  ],
  "version": 4
}

删缓存（非常关键），按 Ctrl + Shift + P → 输入：

CMake: Delete Cache and Reconfigure

重新 配置 \编译 \运行，按 Ctrl + Shift + P → 分别输入：

CMake: Configure
        ↓
CMake: Build
        ↓
CMake: Run Without Debugging