Qt Creator新手需建立“编辑→构建→运行→调试”闭环，常见问题包括窗口闪退（缺app.exec()）、UI文件打不开（后缀隐藏或未加载）、ui_setupUi报错（头文件名不匹配）、修改无效（影子构建缓存），建议清理build目录重构建。
Qt Creator 不是装完就能高效干活的 IDE，新手常卡在“界面太满、不知道点哪、改了没反应”这三步。它默认启动后不自动加载任何项目，也不强制你用某套流程——这既是自由，也是门槛。关键不是学完所有按钮，而是立刻建立「编辑 → 构建 → 运行 → 调试」的最小闭环。
第一次运行 Qt Widgets Application 为什么黑窗口一闪就消失？
这是最典型的新手陷阱：程序执行完 main() 就退出，GUI 窗口根本没机会显示。
- 确认你的
main.cpp中调用了QApplication::exec()（不是return 0;） - 检查是否漏写了
app.exec()或误写成app.exec（少括号） - 若用的是控制台项目模板（
Qt Console Application），它默认不创建 GUI 事件循环，必须手动加QApplication才能显示窗口 - 输出面板里如果出现
QApplication: invalid style override passed, ignoring it.这类警告，一般不影响运行，但说明 Qt 版本和样式配置有轻微不匹配，可暂忽略
双击 mainwindow.ui 没反应？设计模式打不开
不是文件坏了，而是 Qt Creator 没识别出它是 UI 文件——常见于项目未正确加载或文件后缀被系统隐藏。
- 右键点击
mainwindow.ui→ 选择 “Open With” → 强制指定 “Qt Designer (System)” - 检查文件实际扩展名是否为
.ui（Windows 下可能显示为mainwindow，实则是mainwindow.ui被隐藏了后缀） - 若项目刚从外部导入，先右键项目根节点 → “Run qmake”（Qt 5）或 “CMake → Run CMake”（Qt 6），确保构建系统已解析 UI 文件依赖
- Qt 6 默认禁用
uic自动生成头文件，需在.pro文件中确认有FORMS += mainwindow.ui，或在CMakeLists.txt中确认qt_add_resources或qt_wrap_ui已启用
ui->setupUi(this) 报错：‘ui’ was not declared in this scope
这个错误几乎全因头文件包含或命名不一致导致，跟逻辑无关。
- 检查
mainwindow.h是否包含了自动生成的ui_mainwindow.h：#include "ui_mainwindow.h" - 确认
.ui文件名是mainwindow.ui，否则生成的头文件名会是ui_XXX.h，而代码里仍写ui_mainwindow.h就会失败 - 若重命名过
.ui文件（如改成login.ui），必须同步修改构造函数中的ui(new Ui::Login)和头文件包含语句 - Qt Creator 有时不会自动触发
uic重生成，可手动删除build-xxx目录下所有ui_*.h文件，再重新构建一次
改了代码却看不到效果？构建按钮灰色或运行没变化
Qt Creator 的“影子构建”（Shadow Build）机制让源码和构建产物分离，好处是干净，坏处是容易误以为改错了地方。
- 看底部状态栏左下角：是否显示
Debug或Release？如果显示Unconfigured，说明构建套件没选对，点击它手动选一个已配置好的 Kit - 检查“项目”模式（左侧边栏第 5 个图标）→ “构建设置” → “构建目录”是否为空或路径非法；空路径会导致构建失败且无提示
- 改了
.ui文件后，必须保存（Ctrl+S），Qt Creator才会触发uic重新生成ui_*.h；仅修改.cpp不需要额外操作 - 若用了 CMake，确保
CMakeLists.txt中已声明find_package(Qt6 REQUIRED COMPONENTS Widgets)和target_link_libraries，否则链接阶段会静默失败
真正卡住人的，从来不是某个报错信息，而是改了三处地方却不确定哪一处生效、哪一处被缓存、哪一处压根没参与构建。建议每次验证前，先清掉 build- 开头的目录，再点“构建 → 清理项目”，再重新构建——看似慢，实则省去 90% 的“为什么没变”时间。
