必须选非系统盘、无中文、无空格、层级浅的路径,如d:\qt\5.14.2\mingw73_64;否则qt creator会静默跳过qmake和编译器,导致kit识别失败、新建项目无可用套件。

直接说结论:选非系统盘、无中文、无空格、路径层级浅的目录,比如 D:\Qt\5.14.2\mingw73_64。 这不是“推荐”,而是避免后续 Kit 识别失败、qmake 找不到、CMake 配置报错的硬性前提。
为什么不能装在 C:\Program Files 或带中文的路径里?
Qt Creator 启动时会扫描已安装的 Qt 版本和编译器,一旦路径含空格(如 C:\Program Files\Qt)或中文(如 D:\我的开发工具\Qt),qmake 和 mingw32-g++.exe 就可能被跳过或解析失败——这不是警告,是静默忽略,你根本看不到它出现在“构建和运行 → Qt 版本”列表里。
常见现象:
- 新建项目时 Kit 显示为“Desktop Qt 5.14.2 MinGW 64-bit (invalid)”
- 点击“自动检测”后仍为空
- 手动添加 qmake.exe 路径,但提示“qmake: could not exec 'D:/Qt/5.14.2/mingw73_64/bin/qmake.exe': No such file or directory”(其实是路径里的空格或中文导致 shell 解析中断)
推荐路径结构与实际填写示例
安装时在“选择安装路径”界面,直接输入以下任一格式(复制粘贴即可,确保盘符存在):
-
D:\Qt\5.14.2\mingw73_64(最常用,清晰区分版本与工具链) -
E:\Qt\6.8.0\mingw11_64(适配 QT6.8 + MinGW11.2) -
D:\dev\qt\5142(极简风格,适合多版本共存)
关键点:
- 盘符建议用 D: 或 E:,避开 C:(尤其 SSD 容量紧张时)
- 版本号用数字连写(5142)或点号分隔(5.14.2),别用下划线或括号
- 工具链名统一用小写字母+数字+下划线(mingw73_64),QT Creator 内部识别依赖这个命名习惯
装完发现路径不对,还能改吗?
不能热修改。Qt Creator 的 Kit 配置、qmake 缓存、甚至项目 .user 文件都硬编码了原始路径。强行改目录会导致:
- 所有已有项目无法加载 Kit,报错 “
Kit is invalid” - 手动重设
qmake路径后,Qt Version标签页仍显示灰色“Not valid” - 即使重新添加 Qt 版本,旧项目仍沿用错误路径,需逐个编辑 .pro.user 文件
补救方式只有一条:卸载重装,且这次路径一步填对。别指望“移动文件夹 + 修改环境变量”能绕过——Qt Creator 不读 PATH,它只认安装时写死的绝对路径。
真正容易被忽略的细节是:路径本身不报错,但会影响后续所有 Kit 自动识别和项目迁移。很多人卡在“新建项目没 Kit 可选”,折腾半天才发现是当初安装时随手点了默认路径。











