qt creator调试未生效的首要原因是未启用debug构建套件，需检查右下角kit图标是否为黄色感叹号、确认切换至debug模式、安装匹配调试器（如gdb/cdb）、断点应设在mainwindow构造函数而非main()末尾，并勾选“run in terminal”以捕获qdebug输出。
Qt Creator 调试第一个项目，关键不是“能不能启动调试”，而是“断点是否生效、变量能否查看、控制台输出是否可见”——这三者任一缺失，都算调试没真正跑通。
为什么刚创建的项目点 Debug 按钮没反应？
常见原因不是配置错了，而是根本没启用调试构建套件：
- 右下角构建套件图标显示黄色感叹号 → 说明
Kit缺少调试器或 Qt 版本不匹配（比如装了 MinGW 但没装对应mingw-w64的调试器） - 项目用的是
Release构建配置 → 默认关闭调试信息，断点无效；必须切到Debug或RelWithDebInfo - 没安装调试器（如
gdb或lldb）→ Windows 上 MinGW 套件需额外装mingw-w64-x86_64-gdb，Linux/macOS 通常自带，但可能版本太老
main.cpp 里加了断点，但程序直接跑完没停？
这是最常被忽略的细节：Qt Widgets 项目默认入口是 QApplication 启动后立即进入事件循环，main() 几乎立刻返回。断点打在 main() 开头可能来得及，但打在 return app.exec(); 之后就永远不触发。
- 想调试 UI 初始化逻辑，断点应设在
MainWindow构造函数第一行，而不是main() - 如果用的是
QMainWindow模板，检查生成的mainwindow.cpp是否已打开，断点打在MainWindow::MainWindow()内部 - 确认
Projects > Build & Run > Build Steps > Make arguments没加-O2等优化参数（Debug 模式下这些会干扰调试）
控制台输出（qDebug() / std::cout）看不见？
Qt Creator 默认把 stdout/stderr 重定向到“应用程序输出”窗格，但有两个前提：
- 运行配置里必须勾选
Run in terminal（注意：这不是为了弹终端窗口，而是让 Qt Creator 正确捕获输出流） - 项目使用的是 Desktop Kit（非 Android/iOS/Embedded），且 Qt 版本 ≥ 5.15 或 6.x —— 旧版 Qt 在某些 MinGW 下会静默丢弃
qDebug() - 若仍无输出，临时加一句
qInstallMessageHandler([](QtMsgType, const QMessageLogContext &, const QString &msg) { fprintf(stderr, "%s\n", qPrintable(msg)); });验证是否日志机制本身被禁用
Kit 状态、构建配置、断点位置、输出捕获这四者必须同时对齐。尤其新手容易反复点击 Debug 却不看右下角套件图标颜色，或者以为“能编译通过=能调试”。
