必须用命令行加国内镜像,因为qt 5.15+和6.x在线安装器默认连接海外官方服务器,国内直连常因cdn限流或路由异常导致超时、bad gateway或forbidden错误,双击运行会卡死或报错。

Qt Creator在线安装必须用命令行加国内镜像,双击运行大概率卡死或报错
为什么不能直接双击运行安装器
Qt 5.15+ 和 Qt 6.x 的在线安装器默认走官方服务器,国内直连经常超时、返回 server replied: Bad Gateway 或 server replied: Forbidden。你看到进度条卡在 10%–30%,或者弹出“无法下载存档”提示,基本就是这个原因。
常见错误现象包括:
- 安装界面空白或无限加载
- 点击“下一步”后无响应
- 日志里反复出现
http://download.qt.io/online/...请求失败
根本原因是官方 CDN 对国内 IP 限流或路由异常,不是你网络问题,也不是安装器损坏。
必须用命令行启动并指定镜像源
打开 cmd(不是 PowerShell),进入你下载的安装器所在目录,执行带 --mirror 参数的命令。镜像地址必须用 HTTPS,且路径结尾不能带斜杠。
推荐镜像(2026年实测可用):
- 中科大:
.\qt-unified-windows-x64-4.7.0-online.exe --mirror https://mirrors.ustc.edu.cn/qtproject - 清华:
.\qt-unified-windows-x64-4.7.0-online.exe --mirror https://mirrors.tuna.tsinghua.edu.cn/qt - 腾讯云:
.\qt-unified-windows-x64-4.7.0-online.exe --mirror https://mirrors.cloud.tencent.com/qt
注意:qt-unified-windows-x64-4.7.0-online.exe 要替换成你实际下载的文件名;.\ 表示当前目录,别漏掉;路径中不要有中文或空格。
组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。
安装时关键组件怎么选
Qt Creator 本身是独立 IDE,但在线安装器默认只装 Qt 库,不自动勾选 Qt Creator——除非你手动展开“Developer and Designer Tools”节点。
必须勾选的项:
-
Qt Creator(主 IDE,版本号如13.0.2或14.0.0) -
MinGW 11.2 64-bit(或你目标编译器,如MSVC2019_64) -
Qt Debug Information Files(调试必需)
可跳过的项:
-
Qt 3D、Qt Quick Compiler等高级模块,初学不用 -
Qt Installer Framework,打包用,开发阶段非必需
如果安装列表里没看到 Qt Creator,点左下角 Archive 复选框,再刷新筛选——旧版或新版 Creator 都藏在这里。
安装完还要验证 Kit 是否就绪
启动 Qt Creator 后,它不会自动识别刚装的 Qt 版本和编译器。你需要手动配置 Kit:
- 菜单栏
Tools → Options → Kits - 检查
Compilers标签页:应有MinGW x86_64或MSVC 2019条目 - 检查
Qt Versions标签页:路径指向类似D:\Qt\6.7.2\mingw_64\bin\qmake.exe - 在
Kits标签页,新建或编辑一个 Kit,确保三者(Compiler + Qt version + Debugger)全部匹配且无感叹号
最容易被忽略的是 Debugger:MinGW 用户要额外装 MinGW-w64 的 gdb,路径需手动填入 gdb.exe;MSVC 用户则依赖 Visual Studio 自带调试器,没装 VS 就会报错。










