qt creator安装后需配置编译器(mingw/msvc)、qt版本和构建套件(kit)三要素,缺一不可;kit配置成功标志是tools→options→build & run中compilers、qt versions、kits三栏均填满且无警告,否则无法运行。

Qt Creator 安装完不能直接写代码——它不自带编译器和 Qt 库,缺一不可。你得先确认三件事:MinGW(或 MSVC)是否装了、Qt 版本是否选对、Kit 是否配置成功。否则点“运行”只会报错 Cannot run: No executable specified 或卡在“正在构建”。
怎么确认 Kit 配置好了?
打开 Tools > Options > Build & Run,看三个标签页是否都填满:
-
Compilers:有
MinGW x64或MSVC 2019这类条目,路径指向真实安装目录(比如C:\Qt\Tools\mingw112_64\bin\g++.exe) -
Qt Versions:有类似
Qt 5.15.2 (MinGW 64-bit)的条目,路径指向qmake.exe(如C:\Qt\5.15.2\mingw81_64\bin\qmake.exe) -
Kits:至少有一行,Name 是默认名(如
Desktop Qt 5.15.2 MinGW 64-bit),Compiler 和 Qt version 都已下拉选中,且没有黄色感叹号
只要任一栏为空或带叹号,Run 按钮就是灰色的,别硬点。
新建项目时选错模板会卡在 main.cpp 里没 UI
新手常误选 Console Application,结果生成的是纯命令行项目,widget.ui 文件根本不会创建,双击也打不开设计器。真正能拖控件、改界面的,必须选:
-
Qt Widgets Application(适合传统桌面程序,用QWidget或QMainWindow) - 别选
Qt Quick Application(那是 QML,不是 C++ UI) - 别跳过“Create GUI”勾选项——它决定是否生成
.ui文件
选错的话,删掉整个项目文件夹重来最省时间,别试图手动补 .ui。
双击 .ui 文件没反应?检查 Designer 是否启用
不是所有安装包都默认启用 Qt Designer 插件。如果双击 mainwindow.ui 只弹出文本编辑器,说明 Designer 没加载:
- 进
Help > About Plugins,搜索Designer,确保勾选了Qt Designer - 重启
Qt Creator - 再双击
.ui,应该出现拖拽控件的画布,左侧控件栏有Push Button、Label等
这时候改界面才真正开始——改完保存,widget.h 和 widget.cpp 会自动同步声明和槽函数,不用手写 setupUi()。
main.cpp 里 QApplication::exec() 不执行?检查项目类型
常见现象:编译通过、窗口一闪就消失,或者根本没窗口。原因往往是:
- 项目基类选了
QDialog但没调exec()(它需要模态运行) - main.cpp 里漏写了
w.show(),只写了Widget w; - 用了
QMainWindow基类,但没在构造函数里调setupUi(this)(自动生成的代码里本来就有,别删)
最稳妥的起手写法就是保持默认生成的 main.cpp 不动:QApplication a(argc, argv); Widget w; w.show(); return a.exec(); ——少一个分号或大小写错误都会让窗口不出现。
w.show() 忘写了。这些地方没验证完,写再多代码也没法跑起来。











