优化构建 gdb 看不到变量 optimized out 速查
更新时间：2026-10-24。FAQ 速查页，面向用 gdb 调 C/C++ 程序的同学。优化构建 gdb 看不到变量指程序明明带着断点跑起来了，一
<optimized out>，或者断点根本打不到想停的行——病根几乎都在编译选项上：-O2把变量优化没了、-g没开、或者发布构建和调试构建的编译标志混在了一起。它和 error: cannot convert 类型不匹配速查 这类编译期报错不同：程序能编译能跑，只是「不可观测」。这类问题不动代码，改的是 Makefile 里的调试构建配置。本篇以<optimized out>原文为锚逐条定位。
本文要回答的问题
print x回<optimized out>，是 gdb 的问题还是编译的问题？- 加了
-g为什么变量还是看不到？ - 想用接近发布的性能做调试，
-Og和-O2 -g怎么选？ - 为什么发布版里
assert全部失效了？ - 断点设在某行，gdb 却停到别的行或根本不停，怎么回事？
一、报错原文与典型现象
典型现场（工程路径以 /proj/demo 占位），断点命中了，变量却不存在：
$ gdb ./build/app
(gdb) break main.c:28
Breakpoint 1 at 0x40118e: file main.c, line 28.
(gdb) run
Breakpoint 1, process_order (req=0x7fffffffe2a0) at main.c:28
28 total = price * count;
(gdb) print price
$1 = <optimized out>
(gdb) print count
$2 = <optimized out>另几种高发长相：断点设下去 gdb 提示 No line 28 in file "main.c" 或 Function "check_state" not defined（内联函数被展开，符号不存在）；单步执行时光标「乱跳」，一行执行三遍另一行直接跳过（优化器重排了代码）；发布版崩溃后想复现，加日志发现 assert 一行都没触发（-DNDEBUG 把断言编译没了）。读懂现场抓住两件东西：变量是真被优化了还是调试信息根本没生成（file ./build/app 看有没有 with debug_info），编译这行文件时实际用的什么标志（make V=1 或看 compile_commands.json）。
二、病因处置速查表
| 报错现象 / 场景 | 可能原因 | 快速验证 | 处置 |
|---|---|---|---|
print x 回 <optimized out> | -O2/-O3 把变量算进了寄存器或直接消掉 | 看编译命令里优化级别 | 调试构建用 -O0 -g 或 -Og -g 重编 |
| gdb 提示 no debugging symbols found | 没加 -g，或链接后被 strip 剥掉 | file ./build/app 看是否 stripped | 编译加 -g；Makefile 里别对调试产物跑 strip |
| 单步执行光标乱跳、变量值穿越 | 优化器指令重排、尾调用、循环展开 | objdump -dS 对照汇编与源码 | 换 -Og（为调试设计的优化级）减少重排 |
break check_state 打不上 | 小函数被内联，独立符号不存在 | nm ./build/app | grep check_state | 调试构建用 -fno-inline；或在内联展开点下断 |
| 发布版 assert 全部静默 | 发布构建定义了 -DNDEBUG，assert 被预处理删掉 | gcc -E -dM 看 NDEBUG 是否定义 | 调试构建去掉 NDEBUG；或改用不受 NDEBUG 控制的检查宏 |
| 改了 Makefile 调试标志却没生效 | 部分 .o 是旧标志编的，增量构建没重编 | touch 源文件看是否重编 | 切构建配置时 make clean 全量重编 |
三、排查决策图
下面这张图按「调试信息在不在、优化级别对不对」分岔：红是报错入口与命中的根因，蓝是排查动作，绿是验证通过，橙是修复动作，紫是防复发沉淀。
读这张图抓一条主线：先用 file 把「调试信息缺失」和「优化过度」分开——前者补 -g 就行，后者才是本篇的主角；然后确认 Makefile 里调试构建与发布构建是两套独立标志，切换配置时 make clean 全量重编，别让新旧 .o 混着链接。
四、逐条排查展开
<optimized out> 的本质是变量没了。 -O2 下编译器会做常量传播、死代码消除、寄存器分配：一个只在局部用的变量可能从头到尾没进过内存，只活在某个寄存器的某几条指令里，出了那段代码就「不存在」了。gdb 不是不想给你看，是二进制里根本没有这个值可读。处置不是降 gdb 的什么配置，而是重编：调试场景用 -O0 -g（完全不优化，源码与机器码一一对应），想兼顾一点性能用 -Og -g——-Og 是 gcc 专门为调试设计的优化级，只开不干扰调试的优化。
-g 与 strip 的配合坑。 编译加了 -g 但 Makefile 的 install 目标里跑了 strip（或 ld 带 -s），最终二进制照样没有调试信息。file ./build/app 显示 stripped 就是这个病。团队常见做法是编译时 -g 常开，发布时用 objcopy --only-keep-debug 把调试信息拆成单独的 .debug 文件归档，发布产物再 strip——线上 core dump 拿回来还能配上符号。
NDEBUG 是悄悄改语义的标志。 很多工程发布构建加 -DNDEBUG，效果是 assert(...) 宏整片被预处理器删成空语句——发布版里所有断言都不执行。如果你靠 assert 做参数校验，发布版和调试版的行为就不一致了，「我本地怎么测都不崩」常常是这个原因。纪律：断言只用于捕获编程错误，运行期必须做的校验用真正的错误处理代码；需要「发布版也保留的检查」就另写一个不受 NDEBUG 控制的宏。
内联与断点。 小函数（尤其是头文件里的 inline 和模板）在 -O2 下大量内联，函数符号不存在，break func_name 直接打不上。调试构建加 -fno-inline 保符号；或者不降优化，改在调用点下断。
配置混用是团队事故高发区。 Makefile 里 make 默认编发布版、make debug 编调试版，但两者输出到同一批 .o——切来切去时增量构建只重编改动的文件，结果一半的 .o 带 -O2 一半带 -O0，gdb 里一部分变量能看一部分不能看，极度迷惑。处置：调试与发布用不同输出目录（build/debug/ 与 build/release/），或切换时强制 make clean。
五、规范做法与预防
- Makefile 内置两套构建配置：
BUILD ?= release，debug时CFLAGS = -Og -g -fno-inline -fno-omit-frame-pointer，release时-O2 -g加单独 strip 步骤，输出目录分开。 -g常开不亏：调试信息不进内存、不影响运行性能，只占磁盘；发布时拆.debug文件归档即可，线上事故才有符号可配。- 断言纪律写进规范：assert 只抓编程错误；参数校验、外部输入检查走正常错误处理，发布版行为不依赖断言。
- CMake 工程用标准构建类型：
cmake -DCMAKE_BUILD_TYPE=Debug（默认-g）与RelWithDebInfo（-O2 -g -DNDEBUG）分开，别手写字符串拼标志。 -fno-omit-frame-pointer进默认标志：保留帧指针，gdb 回溯和 perf 采样的调用栈都完整，代价微乎其微。- 排错顺序固定化：先
file看调试信息在不在，再看编译命令的优化级别，最后才怀疑 NDEBUG 与内联——按这个顺序两分钟能定位，乱试半天是常态浪费。
这一篇在知识体系里的位置
本篇是 Makefile/CMake 排错速查簇的调试信息篇，管「程序能跑但 gdb 看不动」这一类病。编译期硬报错分流到 error: cannot convert 类型不匹配速查、fatal error 头文件找不到速查、undefined reference 链接错误速查、multiple definition 重复定义速查；构建配置与缓存类问题见 CMakeCache 陈旧行为怪速查、CMake 版本不兼容速查、CMake 找不到编译器速查、CMake 找不到依赖包速查、CMakeLists 语法错误速查、Makefile missing separator 速查；资源与环境类见 make 编译内存超限速查、make 编译器内部崩溃速查、构建 Permission denied 速查、make: No rule to make target 速查、make 构建卡死无响应速查、make 构建输出乱码速查、CMake FetchContent 拉取失败速查、并行构建偶发失败速查；同批的 make 构建磁盘写满速查 与 make 不知道编什么速查 分别管磁盘资源与默认目标。「调试与发布分目录、切配置必 clean」这条纪律对一切双配置工程通用。
一句话总结
gdb 回 <optimized out> 不是 gdb 坏了，是 -O2 把变量优化没了：先 file 确认调试信息在不在（不在补 -g、查 strip），再把调试构建改成 -Og -g -fno-inline 并去掉 -DNDEBUG，Makefile 里调试与发布两套标志分目录输出、切换时 make clean 全量重编，断点能打上、变量能看、断言有效，调试体验才算齐活。