qt creator安装卡住主因是境外镜像源超时,应使用命令行指定国内镜像(如中科大源)并全程保持窗口前台;安装成功后卡死则多因有道词典等软件冲突或配置残留。

Qt Creator 安装卡住不动,大概率不是你电脑慢,而是在线安装器在连接境外源时反复超时或重试失败——尤其是卡在 98%、选择安装路径、或“正在安装组件”这三处,几乎可以确定是镜像源问题。
用命令行强制指定国内镜像源启动安装器
图形界面安装器默认不暴露镜像配置入口,但底层支持 --mirror 参数。直接绕过 GUI 配置,用命令行启动是最稳定有效的解法。
- 确保安装包路径不含中文和空格(如
D:\QtInstall\qt-unified-windows-x64-online.exe) - 打开 CMD 或 PowerShell,
cd /d D:\QtInstall切到安装包目录 - 执行:
qt-unified-windows-x64-online.exe --mirror https://mirrors.ustc.edu.cn/qtproject/(中科大镜像最稳) - Mac/Linux 用户注意:Mac 需调用
Contents/MacOS/qt-unified-mac-x64-online;Linux 需先chmod +x
安装过程中不能最小化、不能休眠、不能切后台
Qt 在线安装器内部使用单线程网络下载+本地解压,一旦窗口失去焦点或系统进入休眠,它不会恢复状态,而是僵死在当前进度——这不是 bug,是设计如此。
- 安装全程保持 Qt 安装器窗口处于前台(哪怕只是边角露出)
- 禁用系统自动休眠:Win 下可临时运行
powercfg -change -standby-timeout-ac 0;Mac 可开「防止自动睡眠」选项 - 关掉所有可能注入 UI 的第三方工具:有道词典、腾讯会议屏幕取词、录屏软件、输入法增强模块
安装后 Qt Creator 打开就卡死,和安装器卡住是两回事
安装成功 ≠ 能用。很多用户以为装完了,结果首次启动 Qt Creator 就无响应,这通常和安装过程无关,而是运行时环境冲突。
- 先关掉
有道词典(尤其带屏幕取词功能的版本),这是 Windows 上最高频的冲突源 - 删除用户配置缓存:
C:\Users\{用户名}\AppData\Roaming\QtProject(Windows)或~/.config/QtProject(Linux/macOS) - 若用的是自编译 Qt(非在线安装器自带),必须在
bin/目录下手动创建qt.conf,内容为:[Paths] Prefix=..
真正容易被忽略的点是:Qt Creator 卡死和安装卡住根本不是同一个问题,但很多人混为一谈。前者查进程、删配置、关冲突软件;后者只有一条路——换镜像源 + 全程盯梢。别在安装器卡住时去重装显卡驱动或删翻译文件,方向错了只会浪费时间。











