Qt6 + MSVC 调试配置避坑指南 (CDB Debugger)

如果你在 Windows 下使用 Qt Creator 配合 MSVC 编译器开发，并且发现无法设置断点、调试直接闪退或者变量显示乱码，这篇指南就是为你准备的。

⚠️ 核心防坑法则：编译器与调试器必须成对！

  • ❌ 错误认知：在 MSVC 编译器下强行使用 LLDB 或 GDB 调试。
  • ✅ 正确做法：MSVC 必须配合 CDB (Console Debugger) 才能正常调试！

🎯 最优解：通过 Qt 维护工具一键安装 (强烈推荐)

很多人（包括我）一开始会在 Visual Studio Installer 里疯狂寻找，或者去下载庞大的 Windows SDK，但经常卡 Bug 装不上。其实最简单的方法就藏在 Qt 自己身上！

第一步：安装 CDB 及 Qt 支持插件

  1. 找到并运行 Qt 安装目录下的 Qt Maintenance Tool (Qt 维护工具)。
  2. 登录账号后，选择 Add or remove components (添加或移除组件)。
  3. 在组件列表中，展开 Developer and Designer Tools (开发者和设计者工具)。
  4. 勾选以下关键选项：
    • Debugging Tools for Windows (这会自动帮你下载微软的 cdb.exe)
    • Qt Creator CDB Debugger Support (这会安装专门解析 QString 等 Qt 类型的插件)
  5. 点击下一步完成安装。

第二步：在 Qt Creator 中关联调试器

  1. 打开 Qt Creator，进入 工具 (Tools) -> 选项 (Options)。
  2. 左侧选择 Kits (构建套件)。
  3. 选中你当前使用的 MSVC 套件 (例如 Desktop Qt 6.x.x MSVC2022 64bit)。
  4. 找到 Debugger (调试器) 一栏，点击下拉菜单。
  5. 此时应该能看到带有 Auto-detected (自动检测) 字样的 CDB 选项（路径通常在 C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\cdb.exe）。
  6. 选中它，点击 Apply 和 OK。

🛠️ 备用方案：手动安装 Windows SDK

如果 Qt 维护工具因网络原因无法下载，你可以手动去微软官网下载独立的 Windows 11 SDK 安装包 (winsdksetup.exe)。

  • 注意：安装时取消所有默认勾选，只保留 “Debugging Tools for Windows” 一项，否则可能会与现有的 VS 环境冲突。

💡 终极检查清单 (排错必看)

当你配置好 CDB 后依然无法调试，请检查以下两点：

  1. 构建模式：Qt Creator 左下角的构建模式必须是 Debug，不能是 Release（Release 不生成 .pdb 符号文件，无法打断点）。
  2. 清理重构：切换调试器后，最好右键项目 -> 清理 (Clean)，然后重新 构建 (Build)。

📝 记录于 2026年 - 献给所有在 MSVC 调试器配置中挣扎过的 Qt 开发者。