2026年告别Qt Creator！用VSCode+CMake搭建现代QT6开发环境（Windows保姆级教程）

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

# 告别Qt Creator！用VSCode+CMake搭建现代QT6开发环境（Windows保姆级教程）

如果你已经习惯了Qt Creator的"一站式"开发体验，但又被VSCode的轻量化和强大插件生态所吸引，那么这篇文章就是为你准备的。我们将带你从零开始，在Windows平台上用VSCode和CMake搭建一个完整的QT6开发环境，并分享一些从Qt Creator迁移过来的实用技巧。

1. 为什么选择VSCode+CMake组合？

Qt Creator确实为QT开发提供了开箱即用的体验，但随着项目复杂度增加，你会发现VSCode+CMake组合带来了更多可能性：

更轻量的IDE体验：VSCode启动速度快，内存占用低，特别适合中大型项目
强大的扩展生态：从代码补全到版本控制，各种插件应有尽有
CMake的灵活性：相比qmake，CMake提供了更强大的项目配置能力
跨平台一致性：一套配置可以在多个平台上使用

迁移到VSCode后，你将获得：

更快的代码导航和搜索
更智能的代码补全
更丰富的调试工具
更好的版本控制集成

2. 环境准备与安装

2.1 安装QT6

首先需要安装QT6开发套件。推荐使用在线安装器，可以按需选择组件：

# 下载QT在线安装器 https://www.qt.io/download-qt-installer

安装时建议选择：

Qt 6.x.x (最新稳定版)
MSVC ²⁰¹⁹⁄₂₀₂₂ (根据你的Visual Studio版本选择)
CMake (如果尚未安装)
Qt Creator (可选，用于参考)

2.2 安装VSCode

从官网下载并安装VSCode：

https://code.visualstudio.com/download

安装后建议立即安装以下基础插件：

C/C++ (Microsoft)
CMake Tools (Microsoft)
CMake (twxs)

2.3 安装构建工具链

确保你的系统已安装：

Visual Studio (带C++开发工具)
CMake (最新稳定版)
Ninja (推荐作为生成器)

# 使用Chocolatey安装(管理员权限) choco install cmake ninja -y

3. VSCode配置QT开发环境

3.1 安装QT插件

在VSCode中搜索并安装以下关键插件：

插件名称	功能描述	必备性
Qt Tools	提供QT智能提示、文档查看等功能	必需
Qt Configure	帮助配置QT环境变量	推荐
CMake Tools	CMake项目支持	必需
C/C++	C++语言支持	必需

> 提示：安装"Qt Extension Pack"可以一次性获取所有推荐的QT插件

3.2 配置QT路径

打开命令面板(Ctrl+Shift+P)，执行：

Qt: Register Qt Installation

然后选择你的QT安装目录（通常是C:Qt6.x.xmsvc2019_64）

3.3 配置CMake工具链

打开命令面板，执行：
```
 CMake: Select a Kit 
```
选择对应的编译器套件（如"Visual Studio Community 2022 Release - amd64"）

设置生成器为Ninja：

// settings.json { "cmake.generator": "Ninja" }

4. 创建和迁移QT项目

4.1 创建新QT项目

使用命令面板创建新项目：
```
 Qt: Create a new project or file 
```
选择"Qt Widgets Application"模板
输入项目名称和位置

生成的CMakeLists.txt会自动包含基本的QT配置：

find_package(Qt6 REQUIRED COMPONENTS Core Gui Widgets) qt_standard_project_setup() qt_add_executable(${PROJECT_NAME} main.cpp mainwindow.cpp mainwindow.h mainwindow.ui )

4.2 迁移现有qmake项目

迁移qmake(.pro)项目到CMake需要以下步骤：

创建新的CMakeLists.txt文件
将源文件和头文件添加到qt_add_executable或qt_add_library
转换qmake配置到CMake：

qmake指令	CMake等效指令
QT += core gui	find_package(Qt6 REQUIRED COMPONENTS Core Gui)
TARGET = app	qt_add_executable(app …)
SOURCES += main.cpp	qt_add_executable(…, main.cpp)
HEADERS += mainwindow.h	qt_add_executable(…, mainwindow.h)
FORMS += mainwindow.ui	qt_add_executable(…, mainwindow.ui)

> 注意：迁移后建议保留原.pro文件一段时间，以便对照检查

5. 高级配置与调试

5.1 调试配置

在.vscode/launch.json中添加QT调试配置：

{ "version": "0.2.0", "configurations": [ { "name": "Debug Qt Application", "type": "cppvsdbg", "request": "launch", "program": "${workspaceFolder}/build/$", "args": [], "stopAtEntry": false, "cwd": "${workspaceFolder}", "environment": [ { "name": "PATH", "value": "${env:PATH};C:/Qt/6.x.x/msvc2019_64/bin" } ], "console": "externalTerminal" } ] }

5.2 自动化部署

在CMakeLists.txt中添加自动部署命令：

# Windows部署 if(WIN32) # 查找windeployqt get_target_property(QMAKE_LOCATION Qt6::qmake IMPORTED_LOCATION) get_filename_component(QT_BIN_DIR "${QMAKE_LOCATION}/../bin" ABSOLUTE) find_program(WINDEPLOYQT_EXECUTABLE windeployqt HINTS "${QT_BIN_DIR}") # 添加部署命令 add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD COMMAND "${WINDEPLOYQT_EXECUTABLE}" "$ 
  
    
    
      " COMMENT "Deploying Qt dependencies..." ) endif()

5.3 常用快捷键配置

建议在keybindings.json中添加以下快捷键：

[ , { "key": "f5", "command": "workbench.action.debug.start" }, { "key": "ctrl+f7", "command": "qt.refreshCompileCommands" } ]

6. 生产力提升技巧

6.1 UI文件实时预览

安装"Qt for Python"插件后，可以实时预览.ui文件：

打开.ui文件
右键选择"Open With…"
选择"Qt Designer"

6.2 代码片段

在VSCode中添加常用QT代码片段：

// snippets/qt.code-snippets " ] } }

6.3 集成版本控制

VSCode内置Git支持，但可以进一步优化：

安装"GitLens"插件增强Git功能
配置.gitignore文件：
```
 build/ .vscode/ *.user 
```

7. 常见问题解决

7.1 找不到QT模块

如果遇到"Could not find Qt6"错误，尝试：

检查QT_DIR环境变量是否设置正确

在CMakeLists.txt中显式指定QT路径：

 set(Qt6_DIR "C:/Qt/6.x.x/msvc2019_64/lib/cmake/Qt6")

7.2 调试时断点不生效

确保：

使用Debug模式编译
在CMake配置中添加：
```
 set(CMAKE_BUILD_TYPE Debug) 
```

7.3 中文乱码问题

在CMakeLists.txt中添加：

if(MSVC) add_compile_options(/utf-8) endif()

迁移到VSCode+CMake确实需要一些前期投入，但一旦配置完成，你会发现开发效率显著提升。我在多个QT项目中使用了这套配置，最大的感受是代码导航和重构变得更加高效，而且可以充分利用VSCode丰富的插件生态来定制最适合自己的工作流。