系统环境：Windows10 / Windows11 64位

---

一、前言：为什么要装 Qt6？

Qt 是目前最主流的跨平台 C++ GUI 开发框架，一次编码可适配 Windows、Linux、macOS 等多系统，广泛应用于桌面软件、嵌入式界面、客户端工具开发等场景。

Qt6 是Qt官方主推的长期支持版本，对比老旧的Qt5，性能更优异、渲染机制更现代化、适配高版本系统与高DPI屏幕，是目前新手入门、项目开发的首选版本。

---

二、下载 Qt 官方在线安装器

目前Qt官方不再提供完整离线安装包，仅支持在线安装，需先下载官方在线安装工具。

官方下载地址：

https://www.qt.io/download-dev

下载对应Windows平台文件：qt-unified-windows-x64-online.exe

重要提示：直接双击安装器默认走国外服务器，下载速度极慢、极易超时失败！必须搭配国内镜像加速安装！

---

三、【关键】中科大镜像加速安装（解决下载慢、安装失败）

这是全网最稳的Qt安装加速方法，完美解决官方下载卡顿、中断问题，操作步骤如下：

1. 将下载好的 qt-unified-windows-x64-online.exe 安装器，放到纯英文无空格路径文件夹，示例：D:\Qt\Install

2. 打开对应文件夹，空白处按住 Shift + 鼠标右键，选择「在此处打开PowerShell窗口」

3. 复制粘贴以下镜像命令，回车启动安装器：

.\qt-unified-windows-x64-online.exe --mirror https://mirrors.ustc.edu.cn/qtproject

通过该命令启动后，会切换为中科大国内镜像源，全程满速下载，杜绝超时、失败问题。

---

四、Qt 账号登录（免费开源即可）

镜像启动安装器后，会自动跳转登录界面，Qt开源版开发完全免费，无需付费：

• 无账号可使用个人邮箱免费注册

• 登录后勾选开源许可协议、同意用户条款

• 无需勾选商业授权，纯学习、开源开发完全够用

---

五、安装路径设置（新手核心避坑点）

Qt安装有硬性路径要求，路径错误会直接导致编译报错、环境失效、程序无法运行，严格遵守以下铁律：

安装路径 禁止中文、禁止空格、禁止特殊符号、禁止中文标点

✅ 正确示范：D:\Qt\6.7.2

❌ 错误示范：D:\桌面软件\Qt 开发工具（中文+空格，必报错）

---

六、核心组件选择（新手最优搭配，不冗余、不缺漏）

无需全选所有组件，冗余组件会占用大量磁盘空间，且新手完全用不到。以下是纯桌面开发、零基础入门最优组件组合，直接照抄勾选即可：

1. Qt 核心版本

勾选：Qt 6.7.2（LTS 长期稳定版），长期支持版稳定性强，适合新手学习和项目开发

子选项仅勾选：MinGW 64-bit

✅ 新手首选MinGW：无需安装Visual Studio、配置简单、编译稳定、零环境适配成本

❌ 放弃MSVC组件：需要额外安装VS开发工具，配置复杂，不适合零基础

2. 开发工具必备组件

展开 Developer and Designer Tools，必勾以下组件：

• Qt Creator（官方开发IDE，代码编写、编译、运行一体化工具）

• MinGW 工具链（C/C++编译工具，程序编译核心依赖）

• CMake、Ninja（新版Qt必备编译工具，适配Qt6编译机制）

• Sources  Qt 完整源码 作用：可以在 Qt Creator 里跳转查看 Qt 底层源码、调试进入 Qt 库内部代码。 存放目录：Qt\6.7.2\Src

• Documentation Qt 官方离线 API 文档 作用：离线查阅所有类、函数说明，不用联网，F1 帮助依赖这个包。 存放目录：Qt\6.7.2\Docs

• Examples（强烈建议一并勾上） Qt 官方示例工程 大量现成 Widget、界面代码，学习非常实用

其余安卓、Web、物联网、嵌入式等模块全部取消勾选，纯桌面开发无需使用。

---

七、正式安装流程

• 确认安装路径、勾选组件无误后，点击Install开始安装

• 依托国内镜像源，下载速度稳定，耐心等待进度条完成即可

• 安装结束后，默认勾选启动Qt Creator，点击完成即可打开开发工具

---

八、安装环境验证（确认安装成功）

安装完成后，必须验证环境是否正常，避免后续开发出现隐性报错：

1. 打开 Qt Creator 软件

2. 新建项目，选择 Qt Widgets Application（桌面窗口项目）

3. 全程默认配置，一路下一步完成创建

4. 点击运行按钮，若能正常弹出空白窗口，说明Qt6环境安装、配置100%成功

---

九、新手安装常见问题汇总

1. 下载速度极慢、频繁超时中断？

未使用国内镜像源导致，务必使用文中的中科大镜像命令启动安装器，可彻底解决该问题。

2. 安装报错、路径无效、编译失败？

检查安装路径，删除中文、空格及特殊符号，更换纯英文路径重新安装。

3. 打开Qt Creator无编译工具、无法运行项目？

安装组件漏选MinGW、CMake工具，重新运行安装器，补装对应核心组件即可。

---

十、总结

1. Qt6新手安装核心核心：镜像加速+纯英文路径+精准勾选组件，三步规避99%的安装问题；

2. 新手优先选择MinGW编译套件，配置简单、上手零难度，适配日常桌面开发学习；

3. 安装完成后务必新建项目验证环境，确保开发环境正常可用，为后续Qt开发打下基础。