Qt Creator怎么调试CMake项目?

风敏酱_9374

风敏酱_9374

2026-08-08

538人浏览

原创

必须将cmake构建类型设为debug且调试器正确关联kit:在projects→build & run→build中添加cmake参数-dcmake_build_type=debug,点击run cmake,并确保kit中debugger指向有效gdb/cdb路径。

qt creator怎么调试cmake项目?

Qt Creator 调试 CMake 项目,核心前提是构建类型必须是 Debug,且调试器(如 gdblldb)已正确关联到 Kit。不是打开 CMakeLists.txt 就能直接点 ▶️ 进入调试——很多卡在这里是因为构建配置没生效。

确认 Kit 中的构建类型是 Debug

Qt Creator 不会自动把 CMake 项目设为 Debug 模式,它默认用 CMake 的 Default 构建类型(等价于 Release)。你必须显式指定:

  • 进入 Projects → Build & Run → Build → CMake arguments
  • 在参数框中添加:-DCMAKE_BUILD_TYPE=Debug
  • 改完后务必点击 Run CMake(不是仅“Apply”),否则 CMakeCache.txt 不更新,构建仍走 Release 流程
  • 如果之前已生成过构建目录(如 build/),建议删掉整个目录再重来——CMake 不会自动覆盖旧缓存中的 CMAKE_BUILD_TYPE

确保调试器被 Kit 正确识别

即使构建成功,没有可用调试器也会弹出 “No debugger set up for this kit” 错误:

CMake 4.3.2
CMake 4.3.2

CMake 4.3.2 Windows x86_64 历史版本安装包,适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。

下载
  • 检查 Projects → Build & Run → Kits → Debugger 是否指向有效的 gdb(Linux/macOS)或 cdb(Windows)路径
  • Linux 下常见问题:系统装了 gdb,但 Qt Creator 启动时没继承 $PATH —— 尤其当你通过桌面快捷方式启动时。解决方法是修改 .desktop 文件,把 Exec 改成:bash -i -c "/path/to/qtcreator"
  • Windows 上若用 MSVC 工具链,需单独安装 Debugging Tools for Windows,并确保 Kit 中 Debugger 选的是 Auto-detect 或手动指定 cdb.exe

断点不命中?检查符号和构建产物位置

断点灰色、提示 “no debug information” 或程序直接跑过不停,大概率是二进制没带调试符号或路径错位:

  • add_executableadd_library 后,确保没加 RELEASE 相关属性(如 set_property(TARGET xxx PROPERTY MSVC_RUNTIME_LIBRARY "MultiThreaded$:Debug>") 是 OK 的,但 set(CMAKE_CXX_FLAGS_RELEASE "") 之类会干扰)
  • 检查构建产物路径是否被 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ...)set(LIBRARY_OUTPUT_PATH ...) 修改过;Qt Creator 默认只监控 build/ 下的默认输出子目录(如 build/bin/),若你自定义了路径,需在 Projects → Run → Run Settings → Executable 中手动指向正确路径
  • Linux 下可手动验证:file build/bin/your_app 应显示 “not stripped”,readelf -S build/bin/your_app | grep debug 应有多个 .debug_* section

CMakeLists.txt 里写 set(CMAKE_BUILD_TYPE Debug) 有用吗?

基本无效,且容易误导。原因很实在:

  • CMake 官方文档明确说明:CMAKE_BUILD_TYPE 只对 single-config 生成器(如 Unix MakefilesNinja)有效,且**必须在命令行传入或通过 Qt Creator 的 CMake arguments 设置**
  • 写在 CMakeLists.txt 里属于“运行时设置”,此时构建类型早已确定,该语句不会回溯修改已解析的构建逻辑
  • 实测:加了这行后 make clean && make 生成的二进制仍是 Release 级别优化,nm -C build/xxx | grep main 会发现符号被优化掉

真正起作用的只有两件事:CMake arguments 里带 -DCMAKE_BUILD_TYPE=Debug,以及对应 Kit 的 Debugger 配置真实可用。其余都是障眼法。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
视频后缀名都有哪些
视频后缀名都有哪些

视频后缀名都有avi、mpg、mpeg、rm、rmvb、flv、wmv、mov、mkv、ASF、M1V、M2V、MPE、QT、VOB、RA、RMJ、RMS、RAM、等等。更多关于视频后缀名的相关知识,详情请看本专题下面的文章,php中文网欢迎大家前来学习。

2023.10.31

9505

17

C++ Qt图形开发
C++ Qt图形开发

本专题专注于 C++ Qt框架在图形界面开发中的应用,系统讲解窗口设计、信号与槽机制、界面布局、事件处理、数据库连接与跨平台打包等核心技能,通过多个桌面应用项目实战,帮助学员快速掌握 Qt 框架并独立完成跨平台GUI软件的开发。

2025.08.15

3562

7

C++ 图形界面开发基础(Qt方向)
C++ 图形界面开发基础(Qt方向)

本专题系统讲解 使用 C++ 与 Qt 进行图形界面(GUI)开发的核心技能,内容涵盖 Qt 项目结构、窗口组件、信号与槽机制、事件处理、布局管理、资源管理,以及跨平台编译与打包流程。通过多个小型桌面应用实战案例,帮助学习者掌握从界面设计到功能实现的完整 GUI 开发能力。

2025.12.05

1341

15

C++ 跨平台开发
C++ 跨平台开发

本专题聚焦 C++ 在跨平台应用与工程构建中的实战应用,系统讲解 CMake 构建系统、跨平台编译配置、第三方库集成、调试技巧、静态与动态链接库管理等核心知识。通过实战案例(如跨平台工具开发、Linux与Windows编译兼容性项目),帮助学习者掌握 从环境配置到完整跨平台构建的开发能力。

2025.10.17

5326

15

c++  cmake用法
c++ cmake用法

本专题整合了c++ cmake用法相关教程,阅读专题下面的文章了解更多详细内容。

2025.10.23

1391

14

C++ 编译构建系统与CMake实战
C++ 编译构建系统与CMake实战

本专题聚焦 C++ 项目的编译与构建体系,系统讲解 CMake 的核心语法、项目结构设计、库与依赖管理、跨平台构建、调试与发布配置。通过完整项目示例,帮助开发者掌握 从源码到可执行程序的工程化构建流程,提升 C++ 项目在实际开发中的可维护性与扩展性。

2025.12.13

314

18

NumPy性能优化版本更新与常见报错排查
NumPy性能优化版本更新与常见报错排查

本专题整理 NumPy 性能优化、版本更新与常见报错排查相关教程,覆盖向量化计算、广播性能、内存布局、NumPy 2.0 升级、版本兼容冲突、安装导入报错、dtype 溢出、矩阵运算异常和 broadcasting 报错修复,帮助读者系统掌握 NumPy 性能调优与问题定位方法。

2026.09.22

0

25

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

2026.09.21

20

20

NumPy随机数文件读写与dtype数据类型
NumPy随机数文件读写与dtype数据类型

本专题整理 NumPy 随机数、文件读写与 dtype 数据类型相关教程,覆盖 Generator/random、随机数种子、正态分布采样、npy/npz/CSV/TXT 保存读取、loadtxt/savetxt、memmap、大文件处理、astype 类型转换、结构化 dtype、整数溢出和精度丢失等场景。

2026.09.21

20

24

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Qt入门课堂 - Qt Quick Controls
Qt入门课堂 - Qt Quick Controls

共0课时 | 0人学习

Qt Creator 调试文档
Qt Creator 调试文档

共0课时 | 0人学习

Qt Creator 项目创建文档
Qt Creator 项目创建文档

共0课时 | 0人学习