qt creator调试配不起来主因是调试器未安装或未正确配置:mingw需手动指定gdb.exe路径,msvc需手动添加cdb路径(如windows kits\10\debuggers\x64\cdb.exe),且架构必须匹配,配置后须重启项目生效。

Qt Creator调试环境配不起来,90%是因为调试器没装或没认上——不是Qt Creator的问题,是它压根不自带调试器,得你手动配。
MinGW项目:GDB路径没填对就看不到调试器
MinGW环境下Qt Creator默认用GDB,但不会自动找。打开 Tools > Options > Kits > Debuggers,点“Add”加一个GDB调试器:
- 名称随便写,比如
MinGW GDB - 路径必须指向实际的
gdb.exe,常见位置:D:\Qt\Tools\mingw110_64\bin\gdb.exe(版本号可能不同) - 别用“自动检测”,它经常漏掉;手动填完要点“Apply”再看Kit里是否可用
- 如果填了还报错
Cannot find GDB binary,说明路径错了,或者权限被杀毒软件拦截(尤其在Win10/11上)
MSVC项目:CDB不装,调试直接灰掉
用MSVC编译器时,Qt Creator无法调用Visual Studio自带的CDB调试器,除非你手动告诉它在哪:
- CDB随Windows SDK安装,路径类似:
C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\cdb.exe - 进
Tools > Options > Kits > Debuggers,添加新调试器,类型选CDB,填上面路径 - 注意:必须用对应架构的CDB(x64项目配x64版CDB),混用会报
Failed to start debugger engine - 如果提示“无法加载dbgeng.dll”,说明Windows SDK没装全,重装SDK并勾选“Debugging Tools for Windows”
QML调试:console.log不输出?检查运行配置
QML里写 console.log("test") 却没输出,不是代码问题,是运行模式不对:
- 进项目
Projects > Run > Run in terminal必须勾选 - 不勾的话,输出走的是Qt Quick Application的GUI进程,
console.log被静默丢弃 - 如果勾了还是没输出,检查
Projects > Run > Environment里有没有误删QT_LOGGING_RULES=*.debug=true - 远程部署到嵌入式设备时,还要确认目标端
gdbserver启动参数带-v(verbose),否则日志被截断
Kit配置失败:红叹号背后的真实原因
右下角Kit图标显示红色叹号,常见但容易被忽略的硬伤:
- 编译器和调试器架构不匹配:比如选了
MSVC 2019 x64编译器,却配了x86 CDB - Qt版本缺失源码:调试Qt自身类(如
QApplication)时,没下载对应版本的Sources组件,断点进不去 - PATH污染:系统PATH里有多个GDB或CDB,Qt Creator随机挑了一个坏的——建议在
Projects > Run > Environment里清空PATH再手动加必要路径
最常被跳过的一步:改完任何调试器或Kit设置后,必须关掉当前项目再重新打开,否则缓存不刷新,看似配好了其实没生效。











