“Unable to create a debugging engine”本质是Qt Creator未配置或配置了与当前编译器不匹配的调试器:MSVC需CDB(cdb.exe),MinGW需GDB(gdb.exe);须在Tools > Options > Kits > Debugger中确认调试器存在且Kit中正确关联。

调试器未配置或不匹配
“Unable to create a debugging engine” 本质是 Qt Creator 找不到可用的、与当前编译器兼容的调试器。不是插件没装好,而是 Kit(构建套件)里 Debugger 字段为 None,或选了 MinGW 套件却配了 CDB,反之亦然。
打开 Tools > Options > Kits > Debugger,检查列表是否为空;若非空,确认所选调试器类型和当前 Kit 的编译器一致:
- MSVC 编译器 → 必须用
CDB(来自 Windows SDK 的cdb.exe) - MinGW 编译器 → 必须用
GDB(如gdb.exe,通常随 MinGW 自带) - Qt Creator 14.x+ 对 GDB 版本更敏感:旧版
GDB 8.1可能失败,需换GDB 11.2.0或更高
Windows 上 CDB 调试器缺失或路径错误
CDB 不随 Visual Studio 默认安装,也不在 Windows SDK 完整安装里自动勾选。即使装了 VS,cdb.exe 很可能根本不存在。
验证方法:在命令行运行 cdb -version,若提示“不是内部或外部命令”,说明未安装或未加入 PATH。
安装要点:
Qt Creator 18.0.2 Windows x86_64 历史版本安装包,适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
- 通过 Windows SDK 安装器(而非 VS Installer)安装,必须手动勾选
Debugging Tools for Windows - 典型安装路径是
C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\cdb.exe,但不同 SDK 版本路径可能含x86或arm64子目录 - Qt Creator 中添加调试器时,必须指向具体
cdb.exe文件,不能只选目录
Linux 下 GDB 未安装或权限受限
Ubuntu/Debian 系统常见报错是 无法找到调试器 “gdb” 或 Ptrace: Operation not permitted。
前者直接安装:sudo apt-get install gdb;后者是内核安全机制拦截调试器 attach 进程:
- 临时生效:
echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope - 永久生效:编辑
/etc/sysctl.d/10-ptrace.conf,设kernel.yama.ptrace_scope = 0 - 别漏装调试符号库:
sudo apt-get install libc6-dbg,否则变量值显示为<optimized out></optimized>
断点灰显或程序不暂停
这往往不是调试器本身问题,而是二进制没带调试信息,或优化干扰了断点命中。
关键检查项:
- 构建套件是否设为
Debug模式(不是 Release) - 构建目录是否被误清或混用——
Build > Clean All后再Rebuild All - 确认编译参数含
-g(GCC/Clang)或/Zi(MSVC),Qt Creator 默认 Debug 模式会加,但自定义 CMakeLists 可能覆盖 - 用命令行验证:
objdump -g your_app | head -n 5,有输出才说明符号存在
真正容易被忽略的是:Kit 的 Debugger 配置和 Build Settings 的构建套件必须指向同一个 Kit 实例,改了 Debugger 却没同步更新 Kit 关联,错误依旧。

















