断点不命中最常见原因是可执行文件缺失调试符号：CMake默认Release模式会禁用-g且启用-O3，导致GDB无法映射源码与机器码；须设set(CMAKE_BUILD_TYPE Debug)，清理build目录后重建，并确保launch.json中program路径准确指向带符号的二进制文件。
为什么断点不命中：debug信息没打进可执行文件里
最常见的情况是编译出来的二进制文件压根没带调试符号，GDB加载后根本不知道哪一行对应哪一段机器码。CMake默认可能用 Release 模式构建，它会自动加 -O3 和 -DNDEBUG，同时丢掉 -g。结果就是你点断点时 VSCode 显示空心圆，鼠标悬停提示“未加载符号”。
必须确保 CMake 配置为 Debug 模式：
-
set(CMAKE_BUILD_TYPE Debug)写在CMakeLists.txt顶部（或传参覆盖） - 如果已有
set(CMAKE_BUILD_TYPE Release)，务必注释掉 - 显式加调试标志更保险：
set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} -g")
改完后要彻底清理构建目录（删掉 build/ 或运行 cmake --build . --clean-first），否则旧的 Release 产物可能被复用。
launch.json 的 program 路径填错：找不到可执行文件
launch.json 里的 program 字段不是源文件路径，也不是 build 目录路径，而是最终生成的、带调试符号的可执行文件的**绝对路径或工作区相对路径**。很多人填成 ${workspaceFolder}/build 或 ${workspaceFolder}/CMakeLists.txt，GDB 启动直接报 Could not find the task 'make' 或 No executable specified。
正确做法：
- 先手动跑一次构建：进入
build/目录，执行cmake .. && make，确认可执行文件确实生成（比如./myapp） - 在
launch.json中写成："program": "${workspaceFolder}/build/myapp"（Linux/macOS）或"program": "${workspaceFolder}/build/myapp.exe"（Windows） - 确保
cwd指向工程根目录，否则程序运行时找资源文件（如 config.json、图片）会失败
preLaunchTask 配置失效：调试前没自动构建
你改了代码，按 F5 调试，结果还是旧逻辑——说明 preLaunchTask 没触发构建。问题通常出在两处：任务名不匹配、tasks.json 没生效。
检查要点：
-
launch.json中preLaunchTask的值（如"preLaunchTask": "build"）必须和.vscode/tasks.json里某个label完全一致（大小写敏感） -
tasks.json的type推荐用"shell"（兼容性好），不要用"process"；command建议明确写"make"或"cmake --build ."，避免依赖 PATH 搜索 - 如果用 CMake Tools 插件，优先用它的内置构建命令（如
CMake: Build），比手写 tasks.json 更稳
临时验证方法：按 Ctrl+Shift+P 输入 Tasks: Run Task，手动选一遍你的构建任务，看终端是否成功输出可执行文件。
CMake Tools 插件没识别 Kit：编译器路径乱码或为空
CMake Tools 插件启动时会自动探测系统中的编译器（GCC、Clang、MSVC），但经常因为环境变量缺失、PATH 污染、或插件缓存过期而失败。现象是状态栏显示 Unable to determine compiler，点击 Kit 选择器全是灰色，cmake.configure 报错说找不到 g++。
解决路径：
- 终端里先确认编译器可用：
g++ --version或clang++ --version能正常输出 - 在 VSCode 里按
Ctrl+Shift+P，输入CMake: Select a Kit，手动选一个带完整路径的（如GCC 12.3.0 (/usr/bin/g++)） - 如果列表为空，点右下角 Kit 位置，选
Scan for Kits；还不行就去设置里搜cmake.cmakePath，手动指定/usr/bin/cmake或你安装的路径
Kit 一旦选错，后续所有构建都可能静默失败——它不报错，但生成的 Makefile 用的是错误编译器，导致调试符号丢失或链接失败，这个坑最容易被忽略。
