目录

前言

1. 安装Cursor

2. 配置Cursor

2.1 安装C++插件

2.2 CMake插件

2.3 Qt相关插件

2.3.1 Qt Tools

2.3.2 Qt Core

2.3.3 Qt C++

2.3.4 Qt UI

2.3.5 Qt Configure

2.3.6 Qt Qml

2.3.7 Qt Extenssion Pack

2.4 汉化包

3. 安装Qt6

4. 环境变量

5. 扩展设置

6. 创建工程 

7. 解决构建问题 

8. 解决关联问题：Qt助手、UI设计器

9. 使用qmake构建项目

10. 再次解决UI设计器打不开的问题(2025-03-20新增)

前言

在 Cursor 中搭建 Qt6 开发环境，您可以按照以下步骤操作。这些步骤结包括：安装Cursor、配置Cursor（选择插件）、安装Qt6、配置环境、创建工程以及解决相关问题。

2025-03-18 修改：

• 删除Qt UI插件的安装。
• 修改Qt Configure配置错误。
• 新增qmake构建说明

新增想法和尝试：

• 尝试补充Qt Support组件，又产生了新的问题，已还原使用Qt Configure（待空闲再研究）
• 本文主要使用cmake构建，改用qmake构建就不行了；在其它电脑上qmake又可行。最终发现是主项目目录的文件夹中有空格，会导致命令行程序找不到pro文件。
• 建议适配你当下所需的环境即可，啥qt插件都想要，太容易冲突了。
• 目前发现用 cursor 阅读shi山代码，效率提升了不少。但是改这种代码还是费劲！

2025-03-20 修改:

• 解决Qt Tools插件打开UI设计器失败的问题

2025-04-09 新的想法： 

• Cursor只用来做编辑器也不错，我自己也只是在虚拟机内部开发，代码工程共享给外部去编辑。
• Curor非常适合用来封装组件（从0-1写代码），在烂代码的基础上最好手动（配合TAB自动补全功能，但TAB功能在处理配置时，会弄掉几项，一定要注意）。

2025-04-14 新增：评论区的展现速度很慢，这里统一说明

关于构建项目的时候出现：配置失败，是否要尝试使用CMake调试程序进行配置？

遇到这个情况，一般是插件自动生成的CMake脚本有错误。需要去解决bug，大概解决方向就是调整库路径或者Qt版本。（我建议用Qt Creator/Visual Studio创建工程，然后用Cursor写代码；当然创建工程这个工作交给AI也可以）

开发环境特殊的情况下，不建议用Cursor构建，比如：需要兼容Qt4、Qt5、Qt6，做一些嵌入式开发，UI设计开发等。现阶段的Cursor无法完全满足所有需求，我将它当作编辑器使用就够了。毕竟Claude大模型、各种工作模式，以及TAB这些提升效率的功能，才是我们想要用它的原因。

1. 安装Cursor

下载链接：https://www.cursor.com/cn/downloads

按需选择版本，这里我选择Windows x64：

​

执行程序：CursorUserSetup-x64-0.46.8.exe

​

选择安装路径：

​

勾选安装选项：

​

安装中：

​

完成：

​

2. 配置Cursor

进入主页面，打开插件（Ctrl + Shift + x）：

​

2.1 安装C++插件

确保相关插件已安装：

​

2.2 CMake插件

​

2.3 Qt相关插件

2025-03-18新增内容：

配置插件过程很头疼，不能全部安装，容易冲突。

如果安装了Qt Configure，最好不要安装Qt Support，会解决一些问题（例如无法打开UI设计器），同时也会导致一些新的问题（cmake构建等，看后面有时间再研究）。

本文主要是使用Qt Configure，在安装Qt Support出问题之后，想要还原，只需要把它卸载即可；同时将Qt Configure添加到工作区建议，即可恢复过来。

​

安装如下Qt插件，不可贪多： （之前安装了Qt UI，现在删除了）

​

关于Qt扩展的描述：

2.3.1 Qt Tools

这是一个为VSCode开发的Qt扩展。它旨在成为一个类似于Qt公司提供的Qt Visual Studio Tools的工具，但它尝试与其他扩展在某些功能上进行协作，例如调试。

该扩展支持通过以下方式提取Qt文件位置：

• CMake
• PATH环境变量

通过此扩展从磁盘中选择不同的Qt版本是不被支持的！

2.3.2 Qt Core

此扩展为其他Qt扩展提供了基本功能。

为了获得更完整的Qt开发体验，请安装Qt All Extensions Pack或其依赖项之一。

功能特性：

• 提供QSS语法高亮
• 提供QDoc语法高亮
• 提供QRC语法高亮
• 查看Qt文档

2.3.3 Qt C++

此扩展帮助您在Visual Studio Code和CMake环境下开发Qt C++项目。

功能特性：

• 使用CMake构建Qt项目
• 调试Qt的C++类型
• 查看Qt文档

前提条件：
需要安装CMake和CMake Tools扩展。这些扩展将自动安装。

如果需要使用Python版本，请安装：Qt for Python

​

2.3.4 Qt UI

此扩展支持使用Qt Widgets Designer和.ui文件设计基于小部件的用户界面。

功能特性：

• 使用Qt Widgets Designer设计基于Qt小部件的用户界面
• 查看Qt文档

2.3.5 Qt Configure

仅支持Windows和Linux。这不是Qt官方工具！！！（重复三次，强调）

在VSCode中生成Qt项目配置文件，按下F5可独立运行并调试Qt项目。

功能特性：

• 命令：QtConfigure: New Project （生成Qt项目配置文件）。
• 命令：QtConfigure: Set Qt Dir（选择Qt安装目录。注意是安装目录，而不是Qt套件目录。该扩展会根据Qt安装路径搜索相应的Qt套件以及编译器）。
• 命令：QtConfigure: Open Qt Designer（打开Qt Designer。此命令仅在生成Qt UI项目后才能使用）。
• 命令：QtConfigure: Open Qt Assistant（打开Qt Assistant）。

CMake：需要配合VSCode的CMake扩展使用。

2.3.6 Qt Qml

此扩展在您使用Visual Studio Code开发Qt Quick应用程序时，为您提供QML语法高亮和代码补全功能。

功能特性：

• 提供QML语法高亮和代码补全
• 提供QML代码检查（Linting）
• 查看Qt文档

2.3.7 Qt Extenssion Pack

这个扩展包包含了开发Qt和Qt Quick应用程序所需的全部扩展集合，专为Visual Studio Code设计。

2.4 汉化包

​

安装后左下角会弹窗，设置语言后，然后自动重启：

​

3. 安装Qt6

下载链接：https://download.qt.io/official_releases/online_installers/

​

这里不展开了，自行安装。

4. 环境变量

将Qt安装路径中：(经过最后的测试，只需要D:\Qt6\6.8.2\mingw_64\bin即可，因为最后启动应用的时候需要关联依赖路径，不可能每次都去拷贝Qt依赖库到你的应用目录下)

D:\Qt6\6.8.2\mingw_64\bin

D:\Qt6\Tools\CMake_64\bin

D:\Qt6\Tools\mingw1310_64\bin

添加到环境变量path： 

​

5. 扩展设置

找到Qt Configure工具：

​

在 Cursor 中补充以下几处：（有错误）

• Mingw Path 对应：D:\Qt6\6.8.2\mingw_64\bin
• Qt Dir 对应安装目录：D:\Qt6
• Qt Kit Dir 对应：D:\Qt6\Tools\mingw1310_64\bin

​

修改为：

• Mingw Path 对应：D:\Qt6\Tools\mingw1310_64
• Qt Dir 对应安装目录：D:\Qt6
• Qt Kit Dir 对应：D:\Qt6\6.8.2\mingw_64

​

然后勾选：将扩展应用于所有配置文件

​

在顶部命令栏中输入> Set Qt Dir，选择如下组件：

​

找到Qt6安装目录，然后点击 “打开Qt安装目录”：

​

 左下角弹窗显示：

​

6. 创建工程 

首先新建一个工作目录：（坑：这里不要带空格，cmake构建没有问题，如果用qmake会报错，也可自行修改批处理脚本）

​

然后在Cursor中打开。

在命令栏输入 > New Project， 找到以下命令：

​

然后输入项目名称：

​

然后在下方的弹窗中依次选择：Qt 套件路径、CMake构建、需要UI。

左侧工作区已生成项目：

​

默认代码已创建：

​

7. 解决构建问题 

运行报错：

[cmake] -- Configuring incomplete, errors occurred!

在命令栏输入  > select a kit，选择工具包

​

选择：

​

然后进行CMake调试，发现：

​

因为我用的是Qt6，所以这里修改为：

find_package(Qt6 COMPONENTS Widgets REQUIRED) # Qt COMPONENTS

还有报错，将Qt5改为Qt6：

target_link_libraries(${PROJECT_NAME} PRIVATE Qt6::Widgets) # Qt6 Shared Library

还是构建失败，注释掉以下内容：

# Specify MSVC UTF-8 encoding  

# add_compile_options("$<$<C_COMPILER_ID:MSVC>:/utf-8>")

# add_compile_options("$<$<CXX_COMPILER_ID:MSVC>:/utf-8>")

完整的CMake脚本如下：

cmake_minimum_required(VERSION 3.5) # CMake install : https://cmake.org/download/
project(test_qt LANGUAGES CXX)
set(CMAKE_INCLUDE_CURRENT_DIR ON)
set(CMAKE_PREFIX_PATH "d:/Qt6/6.8.2/mingw_64") # Qt Kit Dir
set(CMAKE_AUTOUIC ON)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
find_package(Qt6 COMPONENTS Widgets REQUIRED) # Qt COMPONENTS
aux_source_directory(./src srcs)

# Specify MSVC UTF-8 encoding   
# add_compile_options("$<$<C_COMPILER_ID:MSVC>:/utf-8>")
# add_compile_options("$<$<CXX_COMPILER_ID:MSVC>:/utf-8>")

add_executable(${PROJECT_NAME}
    WIN32 # If you need a terminal for debug, please comment this statement 
    ${srcs} 
) 
target_link_libraries(${PROJECT_NAME} PRIVATE Qt6::Widgets) # Qt6 Shared Library

 再次运行，弹出了窗口：

​

8. 解决关联问题：Qt助手、UI设计器

Qt助手和设计器是高频使用的工具，一个用来查看API，一个用来编辑UI，如果能直接关联，会很方便。

打开Qt UI扩展：

​

指定QtCreator中的设计器路径：

​

打开UI文件，然后点击以下按钮，还是打不开。

​

但是通过命令可以打开：

​

​

打开Qt助手也是可以的，但是打不开Qt代码编辑器。

​

​

我感觉有可能是插件冲突了，导致UI文件无法直接用设计器打开。

继续研究，设置Qt tools工具：

​

添加QtCreator路径：

​

发现还是打不开UI文件，然后将Qt UI插件禁用了：

​

这个时候，UI文件的XML文本显示出来了：

​

然后右键选择 “Edit in Qt Designer”：

​

可以用设计器打开UI文件了：

​

9. 使用qmake构建项目

创建项目：

​

输入项目名称：

​

选择qmake：

​

选择带UI文件：

​

这里最好安装一个插件：

​

在这里用来执行批处理文件。

​

编译完成：

​

在终端中输入命令，拉起程序：

​

在适配完qmake之后，又发现ui设计器无法打开了。

右键打开设计器功能是由Qt Tools插件提供的：

​

继续修改Qt Tools插件：

​

改了之后没有生效。继续踩坑....

10. 再次解决UI设计器打不开的问题(2025-03-20新增)

打开Qt Tools设置页面:

​

点击在settings.json中编辑: 

​ 然后在qttools.extraSearchDirectories字段中添加designer.exe路径:

​

然后在UI文件中, 右键点击Edit in Qt Designer:

​

打开UI设计器成功:

​