想装 Qt 写个带界面的小工具,搜出来的结果一半是下载站,一半是过期安装包。qt download 这件事看着简单,渠道选错,装完编译不过、组件缺一堆。

官方渠道就两类

入口在 qt.io 站点的 download 页面。在线安装器只有几十兆,边选边下组件;离线安装包几个 G,适合网速差或要批量部署的场合。开源版和商业版账号体系不同,个人学习走开源版就行。

在线安装器怎么选组件

登录 Qt 账号;选择安装目录;在组件里勾选某个 Qt 版本下的 MinGW 或 MSVC 套件

Windows 上新手直接选 MinGW 套件,自带编译器,装完就能新建项目。选 MSVC 得另外装 Visual Studio Build Tools,否则打开项目会提示找不到编译器。安卓、WebAssembly 这些平台组件按需再补,全勾上多占十几 G。

国内下载慢的处理办法

官方源在国内速度不稳,可以换镜像站,清华、中科大都有 Qt 镜像,把资源地址里的域名替换掉再下。命令行工具 aqtinstall 更省事,指定版本和平台,一条命令拉齐,适合经常重装的人。

装完先做两项检查

打开 Qt Creator,进构建套件页面,看编译器和 Qt 版本是否都正常,图标带黄色感叹号说明没配好。再跑一个自带示例,能编译、能弹出窗口,环境才算通。安装路径别带中文和空格,MinGW 对这两样比较敏感。

卸载重装要留意的两处

重装前用官方 Maintenance Tool 卸载,别直接删安装目录,注册表里的套件信息会残留,再装时组件列表可能对不上。安装器的缓存目录还会留着几十 G 的下载包,装完可以清掉,路径在用户目录下的 AppData 里。装完发现命令行敲 qmake 没反应,是环境变量没配,把 Qt 的 bin 目录加进 Path 就行。

  • 判断提醒:只开发一次,用在线安装器按需勾选最省空间;要长期用或频繁换机器,直接用 aqtinstall 脚本化安装,比手动点更可控。