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(); 之后就永远不触发。

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

• 想调试 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 却不看右下角套件图标颜色，或者以为“能编译通过=能调试”。