根本原因是调试器未正确附加进程或编译缺失调试信息；需确保编译加-g/-zi、program用绝对路径、windows下mingw显式指定midebuggerpath、关闭优化、校准sourcefilemap、处理.dsym路径及多线程调试配置。
VS Code 里 launch.json 不生效，断点全灰？
根本原因通常是调试器没真正 attach 到运行中的进程，或者编译时没带调试信息。VS Code 自己不编译、不运行程序，它只是把你的 launch.json 配置转给 lldb（macOS/Linux）或 cppvsdbg（Windows），再由它们去读取二进制里的 .debug 段。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 确认编译命令加了
-g（GCC/Clang）或/Zi（MSVC）——没这个，launch.json再对也没用 -
program字段必须是绝对路径，比如"${workspaceFolder}/build/main"，不能写"./build/main" - Windows 下用 MinGW 而非 MSVC 时，务必在
launch.json里显式指定"miDebuggerPath": "gdb.exe"，否则默认找cppvsdbg，直接失败 - 如果改了源码但断点不更新，先删掉
build/目录重编译——缓存的旧二进制不会自动重生成调试符号
为什么 gdb 命令行能断，VS Code 却跳过断点？
不是 VS Code 有问题，而是它默认启用「源码映射」和「符号路径校验」，而命令行 gdb 更“野”。常见触发场景：项目用了 CMake 多级构建、源码在 Docker 容器里、或头文件分散在不同路径下。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 检查
sourceFileMap字段是否配置正确，例如本地路径/home/user/proj对应容器内/app，就得写："sourceFileMap": { "/app": "${workspaceFolder}" } - 如果用了
add_subdirectory()或外部库，确保CMAKE_CXX_FLAGS包含-g，且子项目的CMakeLists.txt没覆盖掉它 - 在
launch.json中加"stopAtEntry": true，先看能不能停在main入口——能停说明调试链路通，不能停大概率是路径或符号问题
lldb 在 macOS 上无法读取变量值？
典型表现是 hover 看不到变量内容，Debug Console 里 print var 报 error: Couldn't materialize: couldn't get the value。本质是 Clang 编译时优化干扰了调试信息布局，尤其 -O2 及以上几乎必然出问题。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 开发阶段强制关闭优化：
set(CMAKE_BUILD_TYPE "Debug")，并确认CMAKE_CXX_FLAGS_DEBUG没被误设为-O2 - macOS 上 Clang 默认用
dsymutil把调试信息抽成.dSYM包，VS Code 的lldb插件有时找不到它——把build/main.dSYM和build/main放同一目录，或在launch.json加"miDebuggerArgs": "-o 'settings set target.exec-search-paths /path/to/dsym'" - 避免在
std::vector或std::string的临时对象上设断点，LLDB 对 C++17 后的返回值优化（RVO/NRVO）支持仍不稳定
调试多线程 C++ 程序时，断点只在主线程命中？
VS Code 默认只监听主线程的断点事件，新创建的线程（如 std::thread、pthread_create）跑起来后，调试器可能还没来得及注册其上下文。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 在
launch.json中加"setupCommands": [ { "description": "Enable pretty-printing for gdb", "text": "-enable-pretty-printing", "ignoreFailures": true }, { "description": "Stop on all thread creation", "text": "set follow-fork-mode child", "ignoreFailures": true } ] - 更可靠的做法是在关键线程入口函数第一行手动插
std::this_thread::sleep_for(100ms);，给调试器留出 hook 时间 - 不要依赖「所有线程暂停」图标（⏸️）——它只暂停当前活动线程；想停全部，得在 Debug Console 输入
thread apply all bt触发一次全量栈回溯，此时 lldb 会同步挂起所有线程
调试符号、线程上下文、路径映射这三块最容易漏查。一个断点不命中的问题，80% 出在编译参数或 launch.json 路径拼写上，而不是配置逻辑本身。
