能直接点调试按钮需满足三个前提：断点已设、构建套件选对、可执行文件带调试信息；断点失效常见原因包括源文件未参与编译、代码被优化、源码与构建路径不匹配；Kit选错会导致调试按钮灰显，须确保Compiler、Debugger、Qt版本均有效且匹配；远程调试还需检查部署路径、rsync配置及设备环境获取。

能直接点调试按钮，但必须满足三个前提：断点已设、构建套件选对、可执行文件带调试信息。

断点设置失败的常见表现

点击行号左侧空白处没反应，或红色圆点显示后又自动消失，通常是因为：

• 当前源文件未被编译进目标项目（比如 mainwindow.cpp 不在 .pro 的 SOURCES 列表里）
• 代码已被编译器优化掉（尤其在 Release 模式下未加 CONFIG+=force_debug_info）
• Qt Creator 正在加载符号表，但源码路径与构建路径不匹配（常见于远程部署到 RK3562 等设备时）

验证方式：启动调试前看左下角状态栏是否显示 “Ready”；若显示 “Loading symbols…” 且长时间不动，大概率是路径或调试信息缺失。

构建套件（Kit）选错会导致“调试按钮灰显”

Qt Creator 左下角那个电脑图标旁的 Kit 名称，必须同时满足：

Qt Creator 18.0.2

Qt Creator 18.0.2 Windows x86_64 历史版本安装包，适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。

下载

• 对应一个已配置的 Compiler（如 MinGW 11.2 或 MSVC 2019 x64）
• 绑定一个有效的 Debugger（Linux/macOS 是 gdb，Windows MSVC 必须是 cdb，不是 gdb）
• 关联了正确的 Qt 版本（Qt 6.7.2 for Desktop 这类，不能是 Qt for WebAssembly）

如果 Kit 显示黄色感叹号，点击它进入 “Projects → Build & Run”，检查 Debugger 是否识别为 “Unavailable”。Windows 上用 MSVC 却没装 Windows SDK 调试工具，就会卡在这里。

远程调试（如 RK3562）必须确认部署路径和运行环境

对嵌入式设备调试，光有断点和 Kit 不够，还得确保：

• led_control.pro 中已添加部署规则，例如：unix:!android: target.path = /root
• “Projects → Run → Deploy” 已启用 Deploy files via rsync，且目标 IP（如 192.168.13.30）和用户（如 root）正确
• “Projects → Run → System Environment” 点了 Fetch Device Environment，否则 qDebug() 输出可能被静默丢弃

最易忽略的一点：RK3562 上的 /root 目录需有可执行权限，且 ldd ./led_control 不报 missing library —— 否则程序一启动就崩溃，根本走不到断点。

调试不是按下 F5 就完事，而是从符号加载、路径映射、权限控制到设备环境的连贯链路。任何一个环节断开，都会表现为“点不动”“停不住”“看不到变量”。尤其是跨平台或远程场景，得把 target.path、rsync 配置、Fetch Device Environment 这三处当成固定检查项。