Qt Creator在线安装失败主因是默认官方源国内不可用且强制登录,须用命令行加--mirror参数指定阿里云(https://mirrors.aliyun.com/qt/)等可用镜像源,并避开中文路径、勾选Developer and Designer Tools及配套编译器。

Qt Creator 官网下载安装失败,八成是卡在了网络代理或账号环节——它现在强制要求登录,且默认镜像源在国内基本不可用。
为什么双击安装器会报 Not Found 错误
在线安装器(如 qt-online-installer-windows-x64-4.10.0.exe)启动后,默认尝试从 https://download.qt.io/online/qtsdkrepository/... 拉取元数据,但该地址在国内多数时候超时或返回 404。错误信息里出现的 nirror.sjtu.edu.cn 是拼写错误的镜像域名,说明安装器已尝试 fallback 到某个失效镜像。
- 直接双击运行 = 默认走官方源 + 无代理配置 = 大概率失败
- 清华、阿里等镜像站只提供离线包或旧版在线安装器,新版在线器不兼容其路径结构
- 错误不是你网络差,而是安装器硬编码的 URL 路径和镜像站目录不匹配
用命令行加 --mirror 参数绕过默认源
必须用终端启动安装器,并显式指定可用镜像。目前实测稳定的有:
- 阿里云镜像:
--mirror https://mirrors.aliyun.com/qt/ - 清华大学镜像(仅限部分旧版本):
--mirror https://mirrors.tuna.tsinghua.edu.cn/qt/
操作步骤:
- 打开
cmd或 PowerShell - 把下载好的安装器拖进窗口(自动补全路径),例如:
C:\Users\Me\Downloads\qt-online-installer-windows-x64-4.10.0.exe - 空一格,粘贴参数:
--mirror https://mirrors.aliyun.com/qt/ - 回车执行 —— 此时界面会正常加载组件列表,不再卡在“正在下载元数据”
注册账号时邮箱收不到验证邮件怎么办
Qt 账户注册页面(account.qt.io)对国内邮箱服务商(尤其是 QQ、163)存在投递延迟或拦截,常见现象是“已发送”但 30 分钟内无邮件。
- 优先换用 Gmail 或 Outlook 邮箱注册,成功率接近 100%
- 若必须用国内邮箱,请检查“垃圾邮件”“订阅邮件”“QQ 邮箱的‘其他’文件夹”
- 别反复重发验证邮件,系统有频率限制,可能触发临时封禁
- 教育邮箱(如
@xxx.edu.cn)可走 Qt 教育认证通道,跳过部分验证步骤
安装路径和组件选择的关键避坑点
装完打不开 Qt Creator 或新建项目报 Kit is not valid,往往就栽在这两步上。
- 安装路径不能含中文、空格、特殊符号(如
D:\Qt Projects❌ → 改为D:\Qt✅) - 必须勾选
Developer and Designer Tools,否则Qt Creator本身不会被装进去 - Qt 版本至少选一个编译器配套套件,比如
MinGW 11.2 64-bit或MSVC 2019 64-bit(后者需提前装好 VS) - 如果只勾了 Qt 库没勾对应编译器,Qt Creator 启动后会提示 “No valid kits found”
装完不要急着启动,先去 Tools → Options → Kits 看一眼 Compilers 和 Qt Versions 是否都自动识别成功——这是最容易被跳过的验证动作。


















