VSCode配置Qt开发环境 VSCode编译运行Qt项目教程

云强酱_7090

云强酱_7090

2026-05-15

920人浏览

原创

vscode能运行qt项目,但关键在于构建系统(qmake或cmake)与工具链(msvc/mingw)严格对齐;选错构建方式、混用工具链或头文件路径未配准,是“头文件飘红”“找不到qapplication”“lnk2019”等错误的主因。

vscode配置qt开发环境 vscode编译运行qt项目教程

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 头文件在哪、用哪个编译器。

VSCode
VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载
  • includePath 至少包含两项:"${workspaceFolder}/**" 和你的 Qt 安装路径下的 include 目录,例如 "C:/Qt/6.5.0/msvc2019_64/include/**";漏掉后者,#include <qapplication></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></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 编译会大量报错。路径对了,版本不对,一样白搭。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

vscode

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
C++ Qt图形开发
C++ Qt图形开发

本专题专注于 C++ Qt框架在图形界面开发中的应用,系统讲解窗口设计、信号与槽机制、界面布局、事件处理、数据库连接与跨平台打包等核心技能,通过多个桌面应用项目实战,帮助学员快速掌握 Qt 框架并独立完成跨平台GUI软件的开发。

2025.08.15

4262

7

C++桌面程序开发
C++桌面程序开发

本专题聚焦 C++ 在桌面端图形界面应用开发中的实战应用,系统讲解 Qt 框架的信号与槽机制、界面布局管理、事件响应、数据交互、样式美化与多窗口应用设计等核心知识。通过实战案例(如记事本应用、数据管理工具、系统监控面板),帮助学习者掌握 从UI设计到完整桌面软件开发的C++工程化能力。

2025.10.23

1234

13

C++ 图形界面开发基础(Qt方向)
C++ 图形界面开发基础(Qt方向)

本专题系统讲解 使用 C++ 与 Qt 进行图形界面(GUI)开发的核心技能,内容涵盖 Qt 项目结构、窗口组件、信号与槽机制、事件处理、布局管理、资源管理,以及跨平台编译与打包流程。通过多个小型桌面应用实战案例,帮助学习者掌握从界面设计到功能实现的完整 GUI 开发能力。

2025.12.05

1401

15

vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

2023.06.30

1255

18

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.21

2612

3

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1889

12

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1707

8

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

2587

12

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1798

14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程