Qt Creator本身不编译代码,真正编译依赖配置的编译器(如MinGW 11.2.0)和Qt版本(如Qt 6.5.0),安装必须勾选Qt库、对应MinGW、Qt Creator及配套CMake与GDB,并确保路径纯英文、Kit中Compiler、Debugger、Qt version三项完整配置。

Qt Creator 本身不编译代码,它只是个 IDE;真正干活的是你配的编译器和 Qt 版本。装错组件、路径含中文、Kit 配不全,十个项目九个卡在“无法启动调试器”或“找不到 qmake”。
安装时必须勾选的三个东西
从官网下载的是在线安装器(qt-unified-windows-x64-online.exe),不是离线包——这点很多人忽略,导致装完没编译器。
- 必须勾选:
Qt 5.15.2或Qt 6.5.0(选一个稳定版,别追最新 RC) - 必须勾选对应版本的
MinGW 11.2.0 64-bit(Windows 下最省事的组合) - 必须勾选
Qt Creator本身,以及配套的CMake和GDB(调试用)
装到 D:\Qt 这类纯英文路径下,别放 C:\Program Files 或带空格/中文的目录里——否则 qmake 找不到头文件是常态。
Tools > Options > Kits 里 Kit 配不全等于白装
打开 Tools > Options > Build & Run > Kits,点 Add 新建一个 Kit,缺一不可:
-
Compiler:选你刚装的MinGW 11.2.0 64-bit(路径通常是D:\Qt\Tools\mingw1120_64\bin\g++.exe) -
Debugger:选同目录下的gdb.exe(不是gdb-arm-none-eabi.exe,那是嵌入式用的) -
Qt version:点Add,指向D:\Qt\6.5.0\mingw_64\bin\qmake.exe
如果 Qt version 列表为空,说明你没装 Qt 库,只装了 Creator——重跑安装器补上。
Qt Creator 18.0.2 Windows x86_64 历史版本安装包,适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
新建项目时选错模板,C语言根本跑不起来
Qt Widgets Application 是 C++ 项目,默认带 main.cpp 和 mainwindow.cpp,不能直接写纯 C 代码。
- 想写 C 程序?新建项目选
Non-Qt Project > Plain C Application - 项目生成后,把
.pro文件里这行删掉:CONFIG += c++11 - 再加一行:
QMAKE_CFLAGS += -std=c11(否则struct初始化可能报错)
如果硬要在 Qt Widgets 里混写 C 函数,记得把 .cpp 改成 .c,并在 .pro 中加:SOURCES += main.c,否则 gcc 会按 C++ 规则编译,printf 都可能链接失败。
命令行能跑,Qt Creator 编译报错,大概率是环境变量没继承
Qt Creator 启动时不会自动读取你系统 PATH 里的 MinGW 或 Qt 路径,尤其当你用脚本或终端启动它时。
- 最稳的办法:直接双击桌面图标启动,它会加载安装时注册的环境
- 如果非要命令行启动,先在终端里执行:
set PATH=D:\Qt\Tools\mingw1120_64\bin;D:\Qt\6.5.0\mingw_64\bin;%PATH%(Windows) - 验证是否生效:新建空项目 → 构建 → 看
Compile Output里第一行是不是g++ -c ...,而不是cl.exe(那是 MSVC)
Kit 里明明选了 MinGW,但构建日志里出现 cl.exe,八成是之前装过 VS,Qt Creator 自动 fallback 到 MSVC——删掉 Kit 重配,别信“默认已识别”。

















