qt creator不自带调试器,“unable to create a debugging engine”错误源于后端调试引擎缺失:windows需安装并配置cdb(来自windows sdk的debugging tools),linux需安装带python支持的gdb,macos需授权lldb;且kit中编译器必须与调试器严格匹配(msvc配cdb、mingw配gdb),安装后须重启qt creator。

Qt Creator 本身不自带调试器,报“找不到调试器”或 Unable to create a debugging engine,基本就是调试器没装、没配对、或路径失效了——不是 Qt Creator 坏了,是后端调试引擎缺失。
检查 Debugger 配置是否为空
打开 工具 > 选项 > Kits > Debugger,看列表里有没有条目。如果空着,说明 Qt Creator 根本没检测到任何可用调试器;如果有一条但灰显或带感叹号,说明路径不对或文件已删。
- Windows 上常见情况:装了 Visual Studio 却没装
Debugging Tools for Windows组件 - Linux 上常见情况:
gdb没装,或装了但不在$PATH中(比如只装了gdb-minimal) - macOS 上常见情况:Xcode 命令行工具未安装,或
lldb权限被系统拦截(如首次运行未授权)
Windows 下必须装 CDB 而不是靠 VS 自带 GUI 调试器
VS 安装界面默认不勾选调试工具,Qt Creator 用的不是 VS 的 GUI 调试器(msvsmon.exe),而是命令行版 cdb.exe,它来自 Windows SDK 的可选组件。
- 最稳路径:下载
Windows SDK独立安装器(如win10sdksetup.exe),运行时手动勾选Debugging Tools for Windows - 替代路径:在已安装的 Windows SDK 中右键“更改”,补选该组件(路径通常类似
C:\Program Files (x86)\Windows Kits\10\Debuggers) - 验证是否成功:终端执行
cdb -version,有输出即有效;否则 Qt Creator 即使看到路径也启动失败
Linux 下确认 gdb 是否可用且支持 Python
Qt Creator 的 GDB 插件依赖 Python 扩展(用于变量解析、QVariant 显示等),光有 gdb 不够,还得有 python3-gdb 或对应绑定。
- Ubuntu/Debian:运行
sudo apt install gdb python3-dbg(python3-dbg提供libpython3.x-dbg,避免断点跳过) - CentOS/RHEL:
sudo yum install gdb python3-debuginfo或启用debuginfo仓库 - 验证关键能力:运行
gdb --nx -q -ex "python print('ok')" -ex quit,输出ok才算真正可用
Kit 和 Debugger 必须匹配编译器类型
Qt Creator 的 Kit(构建套件)把编译器、Qt 版本、调试器三者绑在一起。选错组合会直接报错,哪怕调试器本身存在。
- 用 MSVC 编译器 → 必须配 CDB,不能配 GDB(即使装了也会报
Unable to create a debugging engine) - 用 MinGW 编译器 → 必须配 GDB(MinGW 自带的
gdb.exe,路径常为mingwXX_64\bin\gdb.exe) - Qt 5.15 + Qt Creator 14 是个特例:GDB 插件兼容性倒退,建议换用
gdb 11.2或降级到 Qt Creator 13
最容易被忽略的是:CDB 安装后要重启 Qt Creator 才能自动扫描;而 Linux 下装完 gdb 还得检查 gdb --version 输出里是否含 python 字样——没这个,Qt Creator 就当它不支持高级调试功能,直接拒用。











