Qt 开发环境配置

介绍如何在 Windows 系统上配置 Qt 开发环境，使用 Xmake 作为构建工具。

1 安装 Xmake

参考 Xmake 官方文档

2 安装 C++ 工具链

2.1 MSVC

直接安装 Visual Studio，选择 “使用 C++ 的桌面开发” 工作负载即可。

2.2 MinGW

1. 访问 mingw-builds-binaries ，下载最新版本的 MinGW-w64。

2. 解压到指定目录，例如 D:\Toolchains\mingw-w64。

3. 将 MinGW 的 bin 目录添加到系统环境变量 PATH 中，例如 D:\Toolchains\mingw-w64\mingw64\bin。

4. 验证安装是否成功：

   bash

   gcc --version
   g++ --version

2.3 Clang/LLVM

暂略

3 安装 Qt SDK

3.1 官方渠道

访问 Qt 官方网站 下载在线安装程序，此处不再赘述。

3.2 aqtinstall

1. 安装 Python 3.x 及 pipx/uv

   bash

   pipx install aqtinstall

   或者

   bash

   uv tool install aqtinstall

2. 使用 aqtinstall 安装 Qt

   1. 列出可用的 Qt 版本

      bash

      aqt list-qt windows desktop

   2. 列出指定版本的可用架构

      bash

      aqt list-qt windows desktop --arch 6.10.2

   3. 安装指定版本和架构的 Qt (此处架构的选择需要与所使用的编译器对应)

      bash

      aqt install-qt windows desktop 6.10.2 win64_msvc2022_64 --outputdir D:\Qt     

3. 将 Qt 目录添加到 Xmake 的全局配置中

   bash

   xmake g --qt=D:\Qt\6.10.2\msvc2022_64

3.3 自行编译 Qt

暂略

4 创建 Xmake 项目

4.1 MSVC 示例

1. 使用 Xmake 模板创建 Qt 项目：

   bash

   xmake create -t qt.widgetapp MyQtApp
   cd MyQtApp

   可以通过 xmake create -h 查看更多模板选项。

2. 运行：

   bash

   xmake run

   如无意外，会编译并运行一个简单的 Qt 窗口应用：

   

3. 如果想要发布应用，可以使用：

   bash

   xmake install -o build\release\install

   发布的文件会在 build\release\install 目录下。

   警告

   不要直接执行 xmake 命令来编译项目，否则可能会遇到找不到 DLL 的问题。

4.2 MinGW 示例

1. 使用 Xmake 模板创建 Qt 项目：

   bash

   xmake create -t qt.widgetapp MyQtApp
   cd MyQtApp

2. 修改项目配置，指定使用 MinGW 工具链：

   bash

   xmake f -p mingw

3. 运行：

   bash

   xmake run

   如无意外，会编译并运行一个简单的 Qt 窗口应用。

4. 发布应用：同上

5 配置 VSCode 开发环境

安装 VSCode 及相关插件：

• XMake

• clangd

• C/C++

由于对于中大型项目，C/C++ 扩展的语言服务性能很差，因此使用 clangd 用于提供语言服务 (自动补全、跳转、格式化等等)，C/C++ 扩展用于调试。

为避免冲突，需要禁用 C/C++ 扩展的语言服务功能：

C_Cpp.intelliSenseEngine: "Disabled"

5.1 语言服务

1. 打开 xmake.lua，在最上面添加：

   lua

   add_rules("plugin.compile_commands.autoupdate")

2. 如果使用 mingw 工具链，执行：

   bash

   xmake f -p mingw

3. 构建：

   bash

   xmake build

在此之后，可以看到代码的自动补全和跳转功能均可正常使用。

如果不行，尝试重启 VSCode。

5.2 调试

按 F5，选择 C++ (GDB/LLDB)。

6 温馨提示

• 一定要确保所安装的 Qt 版本与所使用的编译器兼容！

• 不要使用 static 类型的模板创建项目，除非你的 Qt 版本是静态编译的。

7 参考资料

• Xmake 官方文档

• xmake 从入门到精通 6：开发和构建 Qt 程序