Qt Creator安装后无法直接编译运行,是因为它依赖外部Qt库和编译器;需在“工具→选项→构建和运行→Kits”中配置Qt版本(qmake路径)与编译器(如MinGW的g++.exe),并确保路径全英文无空格。

Qt Creator 下载安装后不能直接写代码跑起来,是因为它只负责编辑、调试和项目管理,真正编译运行依赖外部的 Qt 库和 编译器。没配好这两样,新建项目点“构建”会报错,比如 No valid kits found 或 Cannot find Qt version。
Kit 红色警告怎么消?
启动 Qt Creator 后,右下角状态栏如果显示红色 Kit(套件)图标,说明它找不到可用的构建环境。这不是软件坏了,是配置没到位。
- 打开
工具 → 选项 → 构建和运行 → Kits,看列表里 Kit 是否带红色感叹号 - 点开那个 Kit,检查「Qt 版本」和「编译器」两项是否为空或标红
- 如果为空,先去「Qt 版本」页添加 Qt 安装路径下的
qmake(Windows 是qmake.exe,Linux/macOS 是可执行文件),路径类似:C:\Qt\5.15.2\mingw81_64\bin\qmake.exe - 再进「编译器」页确认已识别你的编译器:Windows 常见是
MinGW 8.1对应的g++.exe,macOS 是clang,Linux 是gcc/g++ - 最后回到「Kits」页,手动为该 Kit 选中刚添加的 Qt 版本和编译器,保存即可
为什么选 MinGW 而不是 MSVC?
Windows 用户容易在这一步卡住——MSVC 编译器需要你本地已安装对应版本的 Visual Studio(比如 Qt 5.15.2 推荐 MSVC 2019),而 MinGW 是 Qt 安装包自带的轻量级方案,不用额外装 VS。
Qt Creator 18.0.2 Windows x86_64 历史版本安装包,适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
- 如果你没装 Visual Studio,别强行选 MSVC,否则「编译器」页找不到任何条目
- Qt 在线安装器里勾选
MinGW 64-bit组件后,g++.exe默认在C:\Qt\Tools\mingw81_64\bin\(路径含版本号,注意核对) - MinGW 生成的程序不依赖 VC 运行时 DLL,分发更干净;但调试体验略弱于 MSVC(比如断点响应慢一点)
- Qt 6.5+ 对 MinGW 支持更稳,但某些模块(如 WebEngine)仍需 MSVC,这点得看具体需求
Linux/macOS 上编译器路径怎么填?
Linux 和 macOS 不像 Windows 那样有明确安装目录,g++ 或 clang++ 通常在系统 PATH 里,但 Qt Creator 不自动扫描,得手动指定完整路径。
- Linux:终端运行
which g++,结果类似/usr/bin/g++,就填这个;调试器填/usr/bin/gdb - macOS:Xcode 命令行工具装好后,
which clang++一般返回/usr/bin/clang++;若用 Homebrew 装的 Qt,qmake路径可能是/opt/homebrew/opt/qt/bin/qmake - 注意 macOS M 系列芯片用户,Homebrew 默认装在
/opt/homebrew,别错填成旧路径/usr/local - 如果填完仍报错,检查终端里能否直接运行
qmake --version和g++ --version,通不过说明环境变量没生效
中文路径或空格会导致什么问题?
这是新手最常踩却最难排查的坑:只要 Qt 安装路径、项目路径或用户名含中文或空格,qmake 解析就会失败,报错可能五花八门,比如 Project ERROR: Cannot run target compiler 'g++' 或直接卡在解析 .pro 文件。
- 重装 Qt 时,安装路径务必用纯英文,例如
C:\Qt或/home/user/Qt,避开桌面、我的文档、Program Files (x86) - 新建项目时,项目路径也必须全英文无空格,
HelloWorld可以,Hello World或测试项目就不行 - Windows 用户尤其注意:默认安装路径是
C:\Users\用户名\Documents,而用户名是中文的话,整个链路就废了
.pro 文件里写的 QT += widgets 如果对应模块没装,依然会报错。这时候得回头检查安装时是否勾选了 Qt Widgets 模块,而不是只装了个最小化 Qt 库。

















