新安装的Qt5.15.2报错toolchain.prf:76: error: Variable QMAKE_CXX.COMPILER_MACROS is not defined

20260822

疑惑

我刚通过在线安装器[qt-online-installer-windows-x64-4.11.0.exe],成功完成Qt Creator20.0.1和Qt5.15.2的安装,什么原始配置都没修改,只是创建了一个控制台工程,就报错了;而且,竟然打不开已有的.pro工程; 报错信息如下:D:\Qt5.15.2\5.15.2\mingw81_64\mkspecs\features\toolchain.prf:76: error: Variable QMAKE_CXX.COMPILER_MACROS is not defined. cache($${target_prefix}.COMPILER_MACROS, set stash) 非常奇怪的报错

说明Qt Creator → Qt Kit → MinGW 编译器链路本身没有配置成功。

解决方案

实际上跟你的安装操作没有关系, 卸载重装几遍都解决不了问题. 根因是旧版本的缓存没有清理干净.

一句话总结
旧版本Qt Creator缓存的QtProject文件夹在捣鬼。

C:\Users\<用户名>\AppData\Roaming\QtProject

删掉文件夹QtProject。它包含旧版本Qt缓存的残留垃圾, 一般的垃圾清理软件是删不掉它的, 必须手动删除此文件夹QtProject！！

1.检查g++.exe的存在

D:\Qt5.15.2\Tools\mingw810_64\bin\g++.exe

然后手动执行：

"D:\Qt5.15.2\Tools\mingw810_64\bin\g++.exe" --version

g++.exe (x86_64-posix-seh-rev0, Built by MinGW-W64 project) 8.1.0 Copyright (C) 2018 Free Software Foundation, Inc. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

2.检查Qt编译库+MinGW编译器

Qt 5.15.2 有两个东西：

Qt编译库

例如

Qt 5.15.2 MinGW 8.1.0 64-bit

路径为：

D:\Qt5.15.2\5.15.2\mingw81_64

MinGW编译器

路径：

D:\Qt5.15.2\Tools\mingw810_64

二者缺一不可。

3.Compilers

应该：

MinGW D:\Qt5.15.2\Tools\mingw810_64\bin\g++.exe

不要是：

D:\Qt5.15.2\5.15.2\mingw81_64\bin\g++.exe

这个目录里面没有真正编译器。

4.[根因]清理 Qt Creator 缓存

Qt Creator 会缓存 Kit 信息。

关闭 Qt Creator，删除工程目录：

.qmake.stash

例如：

E:\test\hello\.qmake.stash

删除掉也多半不起作用, 它不是根因.

然后删除：

C:\Users\<用户名>\AppData\Roaming\QtProject

里面有：

QtCreator.ini

或者整个：

QtProject

重新打开 Qt Creator，问题完美解决。