1 安装 Xmake

参考 Xmake 官方文档

2 安装 C++ 工具链

2.1 MSVC

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

2.2 MinGW

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

   建议下载 x86_64、posix、seh、ucrt 版本的 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 开发环境

在此处下载最新版的 clangd，解压后将 bin 目录添加到系统环境变量 PATH 中。

安装 VSCode 及相关插件：

• XMake

• clangd

• C/C++

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

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

C_Cpp.intelliSenseEngine: "Disabled"

5.1 语言服务

1. Xmake 的 VSCode 插件会自动在 .vscode 目录下生成 compile_commands.json 文件。

   我们需要配置 clangd 使用这个文件：打开设置 -> 扩展 -> clangd，找到 Clangd: Arguments，添加以下参数：

   json

   --compile-commands-dir=.vscode

   或者在 .vscode/settings.json 中添加：

   json

   {
     "clangd.arguments": [
       "--compile-commands-dir=.vscode"
     ]
   }

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 程序