Windows 下最推荐的 Qt + VS2026 + CMake 开发方案

目标环境

text 复制代码

IDE        : Visual Studio 2026
Qt         : Qt 6.8.3
Compiler   : MSVC 2022 64-bit
Build      : CMake + Ninja
Plugin     : Qt Visual Studio Tools

这是目前 Windows 下最稳定、最现代、最工程化的 Qt 开发方案。

一、前置环境检查

先确保已经安装：

1. Visual Studio 2026

必须包含：

text 复制代码

使用 C++ 的桌面开发

打开：

text 复制代码

Visual Studio Installer

检查是否勾选：

text 复制代码

✔ MSVC v143
✔ Windows 10/11 SDK
✔ CMake tools for Windows
✔ Ninja

二、安装 Qt

打开 Qt 安装器。

Developer and Designer Tools

展开：

text 复制代码

Developer and Designer Tools

勾选：

text 复制代码

✔ Qt Creator（可选）
✔ CMake
✔ Ninja

然后开始安装。

三、安装 Qt VS Tools 插件

打开：

text 复制代码

Visual Studio 2026

进入：

text 复制代码

扩展
→ 管理扩展

搜索：

text 复制代码

Qt Visual Studio Tools

安装。

安装完成后：

关闭 VS。

VS 会自动更新插件。

四、配置 Qt VS Tools

重新打开 VS。

菜单：

text 复制代码

Qt VS Tools
→ Qt Versions

点击：

text 复制代码

Add

选择 Qt 路径，例如：

text 复制代码

D:\Qt\6.8.3\msvc2022_64

然后：

text 复制代码

Apply

五、创建 Qt + CMake 项目（推荐方式）

不要再使用 qmake。

使用：

text 复制代码

File
→ New
→ Project

搜索：

text 复制代码

CMake

选择：

text 复制代码

CMake Project

项目名示例：

text 复制代码

QtDemo

六、推荐目录结构

text 复制代码

QtDemo
│
├── CMakeLists.txt
├── main.cpp
└── src/

后期推荐：

text 复制代码

QtDemo
│
├── CMakeLists.txt
├── src/
├── include/
├── ui/
├── resources/
└── third_party/

七、编写 CMakeLists.txt

这是核心配置。

cmake 复制代码

cmake_minimum_required(VERSION 3.16)

project(QtDemo LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 自动处理 moc/uic/rcc
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTOUIC ON)
set(CMAKE_AUTORCC ON)

# 查找 Qt
find_package(Qt6 REQUIRED COMPONENTS Widgets)

# 可执行文件
add_executable(QtDemo
    main.cpp
)

# 链接 Qt
target_link_libraries(QtDemo PRIVATE
    Qt6::Widgets
)

八、编写 main.cpp

cpp 复制代码

#include <QApplication>
#include <QPushButton>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    QPushButton button("Hello Qt + VS2026");
    button.resize(300, 100);
    button.show();

    return app.exec();
}

九、配置 CMake

打开项目后：

VS 会自动检测：

text 复制代码

CMakeLists.txt

然后右上角会出现：

text 复制代码

x64-Debug

如果没有自动配置：

text 复制代码

项目
→ 配置 CMake

十、关键步骤：让 CMake 找到 Qt

方法1（推荐）

通常 Qt VS Tools 会自动继承 Qt 路径。

一般无需额外配置。

方法2（手动指定 Qt 路径）

打开：

text 复制代码

项目
→ CMake Settings

增加：

json 复制代码

{
  "configurations": [
    {
      "name": "x64-Debug",
      "generator": "Ninja",
      "configurationType": "Debug",
      "inheritEnvironments": [ "msvc_x64_x64" ],
      "buildRoot": "${projectDir}\\out\\build\\${name}",
      "installRoot": "${projectDir}\\out\\install\\${name}",
      "cmakeCommandArgs": "-DCMAKE_PREFIX_PATH=D:/Qt/6.8.3/msvc2022_64",
      "buildCommandArgs": "",
      "ctestCommandArgs": ""
    }
  ]
}

注意：

text 复制代码

D:/Qt/6.8.3/msvc2022_64

改成你的实际 Qt 安装路径。

十一、编译运行

直接：

text 复制代码

Ctrl + F5

或者：

text 复制代码

本地 Windows 调试器

即可运行。

十二、Qt Widgets 开发

以后你可以继续：

添加 QWidget

cpp 复制代码

#include <QWidget>

添加按钮

cpp 复制代码

QPushButton

添加布局

cpp 复制代码

QVBoxLayout

添加信号槽

cpp 复制代码

connect(...)

与 Qt Creator 开发方式基本一致。

十三、Qt Designer 的使用

你仍然可以使用：

text 复制代码

Qt Designer

位置通常为：

text 复制代码

D:\Qt\Tools\QtDesignStudio

或者继续使用：

text 复制代码

Qt Creator

专门负责界面设计。

生成的：

text 复制代码

.ui

文件可以直接被 VS + CMake 使用。

十四、部署 EXE

Qt 程序不能直接裸 exe 发布。

需要使用：

text 复制代码

windeployqt

例如：

bash 复制代码

D:\Qt\6.8.3\msvc2022_64\bin\windeployqt.exe QtDemo.exe

它会自动复制：

Qt DLL
plugins
platforms
imageformats

否则别人电脑无法运行。

十五、推荐技术栈

后续推荐：

技术	推荐
IDE	VS2026
构建	CMake
编译器	MSVC
UI	Qt Widgets
包管理	vcpkg
网络	QNetwork
数据库	Qt SQL
JSON	QJsonDocument
多线程	QThread
图像	OpenCV
音视频	FFmpeg

十六、必须避免的坑

1. 不要混用 MinGW

必须统一：

text 复制代码

Qt MSVC
+
VS MSVC

2. 不要再用 qmake

Qt6 时代：

text 复制代码

CMake 才是主流

3. Qt 路径不要中文

错误：

text 复制代码

D:\软件\Qt

正确：

text 复制代码

D:\Qt

4. 项目路径不要中文

错误：

text 复制代码

D:\桌面\测试项目

正确：

text 复制代码

D:\Projects\QtDemo

十七、MSVC v143 推荐版本

在 VS Installer 中：

搜索：

text 复制代码

MSVC v143

推荐勾选：

text 复制代码

✔ MSVC v143 - VS 2022 C++ x64/x86 生成工具（最新版）

例如：

text 复制代码

v14.44

不要安装：

text 复制代码

（不受支持）

的旧版本。

十八、Ninja 是什么

Ninja 是：

text 复制代码

高速构建工具

它不是编译器。

真正编译代码的是：

text 复制代码

MSVC cl.exe

Ninja 负责：

并行编译
增量构建
编译调度
加快大型工程构建速度

现代 Qt + CMake 项目基本都推荐：

text 复制代码

CMake + Ninja + MSVC

十九、最终推荐方案

最终推荐：

text 复制代码

Qt 6.8.3
+
MSVC v143
+
CMake
+
Ninja
+
Visual Studio 2026
+
Qt VS Tools

这是目前 Windows 平台下最主流、最稳定、最现代的 Qt 工程化方案。