2. Qt与Qt Creator安装

好，咱们正式开始动手。这一章我带你搞定 Qt 5.15.2 的下载、安装，再把 Qt Creator 调顺手。别小看这一步，环境搭好了，后面编译 QGC 能省一半的折腾时间。

我见过不少新手，Qt 版本选错，或者安装时漏了组件，结果编译报错一整天。嗯，咱们别走那个弯路。

2.1 为什么是 Qt 5.15.2？

QGC 官方推荐的是 Qt 5.15.x 系列。我个人习惯用 5.15.2，因为这个版本在稳定性上表现最好。你可能会问：Qt 6 都出来了，为什么不用新的？

说白了，QGC 的核心依赖库（比如 MAVSDK、PX4 的通信协议栈）在 Qt 5.15 上验证得最充分。我在项目中试过 Qt 6，编译能过，但运行时偶尔会出现奇怪的界面闪烁。所以，稳妥起见，咱们选 5.15.2。

2.2 下载 Qt 5.15.2

Qt 的下载渠道有两个：官方在线安装器和离线安装包。我建议你用离线包，原因很简单——在线安装器在国内网络环境下经常断，下载到一半重来，很崩溃。

离线安装包的获取方式：

• 官方存档：https://download.qt.io/archive/qt/5.15/5.15.2/
• 清华镜像：https://mirrors.tuna.tsinghua.edu.cn/qt/archive/qt/5.15/5.15.2/

选哪个？我推荐清华镜像。速度快，而且文件完整。我曾经在官方源下载过损坏的包，解压时报错，白白浪费半小时。

你需要下载的文件（根据你的操作系统选一个）：

操作系统	文件名	大小
Windows (64-bit)	qt-opensource-windows-x86-5.15.2.exe	约 2.8 GB
Linux (64-bit)	qt-opensource-linux-x64-5.15.2.run	约 2.5 GB
macOS	qt-opensource-mac-x64-5.15.2.dmg	约 2.6 GB

2.3 安装 Qt 5.15.2

安装过程其实不复杂，但有几个关键点你得注意。我按步骤拆开讲。

2.3.1 Windows 安装

1. 双击运行 qt-opensource-windows-x86-5.15.2.exe。
2. 跳过 Qt 账号登录（点 Skip）。
3. 选择安装路径。我个人习惯用 C:\Qt\Qt5.15.2，路径里不要有中文和空格。
4. 最关键的一步：组件选择。默认只选了少量组件，你得手动勾选以下内容：

组件选择清单（必选）：

组件分类	具体组件	说明
Qt 5.15.2	MSVC 2019 64-bit	Windows 下编译 QGC 必须
	MinGW 8.1.0 64-bit	可选，但建议装上
	UWP 相关组件	不需要，别勾
Developer and Designer Tools	Qt Creator 4.15.2	IDE，必须
	Qt Installer Framework	打包工具，建议装
	Debugging Tools for Windows	调试用，建议装

2.3.2 Linux 安装

Linux 下安装稍微不同。下载的 .run 文件需要先给执行权限：

chmod +x qt-opensource-linux-x64-5.15.2.run
./qt-opensource-linux-x64-5.15.2.run

组件选择和 Windows 类似，但注意：

• Linux 下编译 QGC 主要用 GCC，所以勾选 Desktop gcc 64-bit。
• 如果你用 Ubuntu 20.04 或 22.04，系统自带的 GCC 版本是 9.x 或 11.x，都能兼容。

我曾经在 Ubuntu 22.04 上踩过一个坑：系统 GCC 版本太高（12.x），编译 QGC 时某些旧代码会报错。解决办法是安装 GCC 11：

sudo apt install gcc-11 g++-11
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-11 100

2.3.3 macOS 安装

macOS 最简单。下载 .dmg 文件，双击打开，把 Qt 拖到 Applications 文件夹就行。组件选择时，记得勾选 Desktop clang 64-bit。

2.4 Qt Creator 配置

安装完 Qt，咱们来配置 Qt Creator。这是你写代码、编译、调试的主战场。

2.4.1 设置编译器

打开 Qt Creator，进入 工具 → 选项 → 构建和运行 → 编译器。正常情况下，Qt Creator 会自动检测到已安装的编译器。如果没有，手动添加：

• Windows：添加 MSVC 2019 64-bit（路径在 C:\Program Files (x86)\Microsoft Visual Studio\2019\...）。
• Linux：添加 GCC（路径通常是 /usr/bin/gcc）。
• macOS：添加 Clang（路径 /usr/bin/clang）。

2.4.2 设置 Qt 版本

在 构建和运行 → Qt 版本 里，点击“添加”，找到你安装的 qmake 路径：

• Windows：C:\Qt\Qt5.15.2\5.15.2\msvc2019_64\bin\qmake.exe
• Linux：/home/你的用户名/Qt5.15.2/5.15.2/gcc_64/bin/qmake
• macOS：/Users/你的用户名/Qt5.15.2/5.15.2/clang_64/bin/qmake

添加后，Qt Creator 会显示 Qt 5.15.2 的版本号。如果显示“无法解析”，说明路径不对或者安装有问题。

2.4.3 设置构建套件（Kit）

这是最后一步，也是最容易出错的地方。在 构建和运行 → 构建套件 里，创建一个新套件：

字段	设置值
名称	Qt 5.15.2 MSVC2019 64bit（或你喜欢的名字）
设备类型	桌面
编译器	选择你刚才添加的编译器
调试器	自动检测，如果没有就手动添加
Qt 版本	选择 Qt 5.15.2
CMake 工具	如果你安装了 CMake，这里会自动检测

2.5 验证安装

配置完成后，咱们写个简单的程序验证一下。新建一个项目：

1. 文件 → 新建文件或项目 → 应用程序 → Qt Widgets 应用程序。
2. 项目名称随便起，比如 HelloQGC。
3. 构建套件选择你刚才创建的套件。
4. 直接点“完成”，然后按 Ctrl+R 运行。

如果看到一个空白窗口弹出来，恭喜你，环境搭建成功了。

2.6 知识结构图

下面这张图帮你理清 Qt 环境搭建的完整流程和组件关系：

2.7 常见问题与避坑

最后，我把自己踩过的坑列出来，你遇到了直接对照解决。