VSCode能运行Qt项目，但关键在于构建系统（qmake或CMake）与工具链（MSVC/MinGW）严格对齐；选错构建方式、混用工具链或头文件路径未配准，是“头文件飘红”“找不到QApplication”“LNK2019”等错误的主因。
VSCode 能跑 Qt 项目，但不是装几个插件点几下就完事——关键在构建系统（qmake 或 cmake）和工具链路径是否真正对齐。选错构建方式、混用 MSVC/MinGW 工具链、头文件路径漏配，是 90% 的“头文件飘红”“找不到 QApplication”“编译报 LNK2019”问题的根源。
确认你用的是 qmake 还是 CMake 项目
Qt 项目分两类：老项目多用 .pro 文件（qmake），新项目默认用 CMakeLists.txt（CMake）。二者配置逻辑完全不同，不能套用同一套 tasks.json 或 CMakeTools 设置。
- 打开项目根目录，看有没有
project.pro：有 → 你走 qmake 路线，跳过 CMakeTools 配置，重点配tasks.json和c_cpp_properties.json - 看有没有
CMakeLists.txt：有 → 你走 CMake 路线，必须装CMake Tools插件，并在 VSCode 侧边栏点击 “CMake” 视图完成配置，tasks.json基本不用动 - 两者都有？删掉一个。混用会导致
qmake生成的Makefile和 CMake 生成的build目录冲突，clean都清不干净
qmake 项目必须手动配 c_cpp_properties.json
VSCode 的 IntelliSense 不读 .pro 文件，所以即使 qmake 能编译成功，编辑器里照样飘红。必须显式告诉它 Qt 头文件在哪、用哪个编译器。
-
includePath至少包含两项："${workspaceFolder}/**"和你的 Qt 安装路径下的include目录，例如"C:/Qt/6.5.0/msvc2019_64/include/**"；漏掉后者，#include <QApplication>就标红 -
compilerPath必须指向你实际使用的编译器二进制，比如"C:/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/14.36.32532/bin/Hostx64/x64/cl.exe"（MSVC）或"C:/Qt/Tools/mingw1310_64/bin/g++.exe"（MinGW）；选错会导致 IntelliSense 模式（intelliSenseMode）不匹配，补全失效 - Windows 下 MSVC 项目别写
windows-gcc-x64，要写windows-msvc-x64；MinGW 才用gcc系列值
CMake 项目依赖 CMake Tools 插件自动发现
CMake Tools 插件不是可选项，它是 CMake 项目的“驱动器”。它负责调用 cmake 命令、解析 CMakeLists.txt、生成构建缓存、暴露目标列表——没它，VSCode 根本不知道你的项目里有哪些可执行目标。
- 安装后，按
Ctrl+Shift+P输入 “CMake: Select a Kit”，从列表里选带 “msvc2019_64” 或 “mingw81_64” 后缀的套件；不要选 “Visual Studio Community 2022” 这种纯 IDE 套件，它不含 Qt 工具链 - 在侧边栏 “CMake” 视图中点击 “Configure”，VSCode 会调用
cmake并把输出打印在终端里；如果报错 “Could NOT find Qt6”，说明CMAKE_PREFIX_PATH没设对，需在设置里填入 Qt 安装路径下的lib/cmake/Qt6目录，例如"C:/Qt/6.5.0/msvc2019_64/lib/cmake/Qt6" - 配置成功后，“Build” 按钮才可用；右键目标名选 “Build” 或 “Debug”，VSCode 会自动调用
cmake --build，无需手写tasks.json
运行前务必检查构建产物路径和 Qt DLL 依赖
编译通过 ≠ 能运行。Windows 下 Qt 程序启动时会动态加载 Qt6Core.dll、Qt6Gui.dll 等，这些 DLL 必须在 PATH 里，或跟 exe 放同一目录。
- MSVC 构建的 exe 默认依赖
msvcp140.dll、vcruntime140.dll，它们通常在System32或 Visual Studio 的redist目录；若提示“找不到 vcruntime140d.dll”，说明你用了 Debug 版运行时，但没装 VS 的调试运行时组件 - Qt DLL 不在 PATH？最简单办法是把
C:/Qt/6.5.0/msvc2019_64/bin加进系统环境变量；或者用windeployqt工具自动拷贝（命令：windeployqt --no-translations --no-opengl-sw <your_app.exe>） - QML 项目额外需要
Qt6Qml.dll和Qt6Quick.dll，windeployqt默认不打包它们，得加--qmldir参数指定 QML 源码路径
最常被忽略的是构建系统与 Qt 安装版本的隐式绑定：Qt 6.5.0 msvc2019_64 版本只能配 Visual Studio 2019/2022 的 MSVC 工具链，不能强行塞进 MinGW 编译器路径；反过来，Qt 6.5.0 mingw_64 版本的头文件里有 GCC 特定宏，用 cl.exe 编译会大量报错。路径对了，版本不对，一样白搭。
