Clang编译C++时必须显式加-g才能生成DWARF调试信息，推荐搭配-O0和-fno-omit-frame-pointer以确保变量可见、行号准确及栈回溯可靠；避免与-O2及以上优化混用，否则调试体验极差。
Clang编译C++时如何启用Debug信息
Clang默认不生成调试信息，直接 clang++ main.cpp 编译出的二进制无法用 gdb 或 lldb 单步、设断点、查看变量。必须显式加 -g 才能生成完整 Debug 符号。
-
-g是最低要求，生成 DWARF 格式调试信息（Linux/macOS 通用） - 推荐搭配
-O0：关闭优化，否则变量可能被寄存器优化掉、代码行号错乱、控制流被重排 - 可选加
-fno-omit-frame-pointer：方便栈回溯，尤其在调试崩溃时更可靠 - 避免混用
-g和-O2或更高优化等级——不是报错，但调试体验极差
完整的Debug编译命令示例
一个典型可用的 Debug 构建命令是：
clang++ -g -O0 -fno-omit-frame-pointer -std=c++17 main.cpp -o main
说明：
-
-std=c++17显式指定标准，避免依赖默认版本（不同 Clang 版本默认值不同） - 如果项目有头文件路径，加
-I./include；链接库加-L./lib -lmylib - macOS 上若遇
ld: library not found for -lc++，补上-stdlib=libc++
验证Debug信息是否生效
编译完别急着调试，先确认符号存在：
立即学习“C++免费学习笔记（深入）”；
- Linux：运行
file main应显示with debug_info；readelf -w main | head -n 5能看到 DWARF 段 - macOS：运行
file main应含has debug symbols；dsymutil -dump-debug-map main可查符号映射 - 最直接：启动
lldb ./main后输入b main，能成功设断点且不提示Could not resolve breakpoint to any actual locations
常见错误：为什么加了-g还是调试不了？
现象包括：断点显示 pending、变量显示 <optimized out></optimized>、源码不显示、step over 直接跳函数外。
- 实际用了
-O1或更高优化：检查 Makefile / CMakeLists.txt 中是否隐式启用了优化（如 CMake 的CMAKE_BUILD_TYPE=Release） - 编译和链接分两步，只在编译加
-g，链接时没传过去：确保-g出现在最终链接命令中（Clang 会透传，但自定义链接脚本或使用-fuse-ld=...时可能丢失） - 源文件路径变更过：调试器按编译时的绝对路径找源码，移动项目后需用
lldb的settings set target.source-map重映射 - 使用了
-flto（LTO）：LTO 默认剥离调试信息，必须加-g且确保整个构建链（编译+链接）都支持 LTO+debug，较复杂，Debug 阶段建议禁用
Debug 构建的核心就两条：-g 不能少，-O0 最安全。其余都是围绕这两条防干扰的细节。
