01-下载与安装：阿里云镜像加速¶

目标¶

你可能还会看到 Offline Installer（离线包）： - 类比：像“整包快递”，一次性下载一个很大的完整包 - 结论：新手优先用在线安装器，配合镜像更省事

专业名称：Mirror（镜像站）
类比：同一份货（Qt 安装包）在很多仓库都有，你选离你近、速度快的仓库下载
作用：显著降低超时/断线/卡进度条的概率
规则/坑点：Qt 安装器的 --mirror 需要填“镜像站根地址”，不要填完整的 /online/... 路径，并且不要在末尾加 /（这点是安装器的约定）
参考：Qt Wiki 的说明与示例（--mirror，以及“不要使用完整路径、不要以 / 结尾”）Qt Wiki: Online Installer 4.x

.\qt-unified-windows-x64-*-online.exe --mirror https://mirrors.aliyun.com/qt

说明： - https://mirrors.aliyun.com/qt 是镜像站根地址示例；安装器会自己拼出后续的 /online/qtsdkrepository/... 路径 - 如果你下载的是 32 位安装器或 ARM 版本，文件名会不同，但 --mirror 的写法一样

在终端里进入安装器所在目录，然后：

./qt-unified-*-online.* --mirror https://mirrors.aliyun.com/qt

你会看到类似这些 Kit（套件）： - MinGW：Qt 自带一套 GCC 工具链，上手更省事 - MSVC：使用 Visual Studio 的编译器，更贴近企业开发环境

新手建议（更省心）： - 先选 MinGW 这一套（安装器里通常会给你配好对应版本） - Qt Creator 勾选默认就行（它是你主要的 IDE）

错误：双击直接启动安装器，但下载阶段一直超时/卡住
结果：进度条来回重试，甚至卡在 99%
正确：用命令行加 --mirror 指定镜像站（见 3.2）
错误：给 --mirror 填了很长的完整路径（带 /online/...）或末尾带 /
结果：安装器拼接出来的地址不对，导致下载失败
正确：只填“镜像根地址”，并且不要以 / 结尾（见 Qt Wiki）
参考：Qt Wiki: Online Installer 4.x
错误：不知道该换哪个镜像
结果：一直碰运气
正确：从官方镜像列表挑一个离你网络更近的（安装器也支持 --mirror 切换）
参考：Qt Wiki 提到的 mirrorlist 地址（示例为 Windows x86 仓库）Qt Wiki: Online Installer 4.x

如果能跑起来，说明： - Qt 本体安装 OK - 你选的编译器/Kit 可用 - Qt Creator 能正确找到 Qt 与工具链