Qt Widgets Application是新手首选模板,它自动生成QApplication、MainWindow类和.ui文件,开箱即用;需确保路径无中文空格、正确选择Kit、.pro文件含QT += widgets、main.cpp调用w.show()且执行a.exec()。

Qt Widgets Application 是新手最该选的模板,其他选项容易卡在编译或运行阶段。
选错模板会导致项目根本跑不起来
常见错误现象:点了 Qt Quick Application 或 Qt Console Application,结果 main.cpp 里没 QApplication 实例、窗口不显示、控制台一闪而过。这不是代码写错了,是模板本身就不提供 GUI 主循环。
-
Qt Widgets Application自动生成QApplication+MainWindow类 +.ui文件,开箱即用 - 路径里不能有中文或空格,否则 qmake 会报
Project ERROR: Cannot run target compiler 'g++'或类似路径解析失败 - 别跳过“选择 Kit”步骤——哪怕只装了 MinGW,也要确认右侧勾选状态,否则构建按钮灰色不可点
.pro 文件里 QT += widgets 必须存在
新建完项目后立刻检查根目录下的 xxx.pro 文件。如果没这行,QWidget、QPushButton 等类会标红,编译报 undefined reference to `vtable for MainWindow'。
- 手动加一行:
QT += widgets(不是core或gui单独写) - 如果用了
QSqlDatabase等模块,才额外追加sql;network同理 - 改完
.pro文件必须点击右下角Run qmake按钮,否则改动不生效
运行前先确认 main.cpp 是否调用 show()
很多教程省略这一步,但实际项目里常有人删掉或注释掉 w.show(),导致程序启动后黑屏、无窗口、进程已存在但看不见。
- 标准结构必须包含:
QApplication a(argc, argv);→MainWindow w;→w.show();→return a.exec(); - 如果改成
w.showFullScreen()或w.setFixedSize(800,600),要确保没和.ui文件里的布局冲突 - 调试时看
Application Output窗格有没有输出,没输出大概率是show()没执行
.pro.user 文件不要复制到新项目里,它存的是你本地 Qt Creator 的调试配置、断点、窗口大小等私有状态,别人打开会报 kit 不匹配、无法构建。删掉再重新配置,比硬扛兼容问题快得多。


















