4. GCC 常用编译选项：-O、-Wall、-g、-I 和 -L

GCC 的编译选项，说白了就是你和编译器沟通的「开关」。每个开关控制一个行为，用对了事半功倍，用错了……嗯，我见过不少同事在调试时抓耳挠腮，最后发现只是少了个 -g 选项。

这一章我们聚焦五个最常用的选项组：优化级别、警告控制、调试信息、头文件路径和库路径。它们几乎出现在每一个实际项目中。

4.1 优化级别：-O0、-O1、-O2、-O3、-Os

优化级别控制编译器对代码的「改造程度」。级别越高，生成的可执行文件通常越快，但编译时间更长，调试也更困难。

我个人习惯在 Makefile 里这样写：

# 调试版本
CFLAGS_DEBUG = -O0 -g -DDEBUG

# 发布版本
CFLAGS_RELEASE = -O2 -Wall -Werror

4.2 警告选项：-Wall、-Wextra、-Werror

警告不是错误，但忽视警告往往埋下隐患。我见过太多线上事故，根源就是编译器早就警告过，但没人当回事。

-Wall 并不是「所有警告」，它只开启一组常用的警告。要更全面，可以加上 -Wextra。而 -Werror 会把所有警告当作错误处理——编译直接失败。

举个例子，未初始化的局部变量：

// test.c
#include <stdio.h>

int main() {
    int x;
    printf("%d\n", x);  // x 未初始化
    return 0;
}

编译看看：

$ gcc -Wall test.c -o test
test.c:5:17: warning: 'x' is used uninitialized [-Wuninitialized]
    5 |     printf("%d\n", x);
      |                 ^

如果没有 -Wall，这个警告根本不会出现。程序可能每次运行结果都不一样，排查起来非常头疼。

4.3 调试信息：-g 与 -g3

-g 选项告诉 GCC 在可执行文件中嵌入调试信息。这些信息包括源码行号、变量名、函数名等，是 GDB 等调试器工作的基础。

-g3 比 -g 包含更多信息，比如宏定义。如果你在代码里用了大量宏，调试时想查看宏展开后的值，就用 -g3。

# 编译时带调试信息
gcc -O2 -g app.c -o app

# 剥离调试信息，生成发布版
strip app -o app_release

# 保留调试符号文件
objcopy --only-keep-debug app app.debug

你想想看，如果线上程序崩溃了，没有调试信息，你只能看到一堆地址。有了 .debug 文件，就能定位到具体的源码行。这差别有多大，不用我多说了吧。

4.4 路径指定：-I 和 -L

这两个选项解决的是「编译器去哪里找文件」的问题。

• -I：指定头文件搜索路径
• -L：指定库文件搜索路径

为什么需要手动指定？因为编译器默认只搜索系统标准路径（如 /usr/include、/usr/lib）。你自己的项目目录、第三方库目录，都需要显式告诉编译器。

# 头文件在 include/ 目录
# 库文件在 lib/ 目录
gcc -I./include -L./lib main.c -lmylib -o app

这里 -lmylib 链接的是 libmylib.so 或 libmylib.a。GCC 会自动加上 lib 前缀和 .so/.a 后缀。

4.5 综合示例：一个实际项目的编译命令

下面是一个嵌入式项目的典型编译命令，包含了本章所有选项：

arm-none-eabi-gcc \
  -mcpu=cortex-m4 \
  -mthumb \
  -O2 \
  -g3 \
  -Wall -Wextra -Werror \
  -I./include \
  -I./drivers/include \
  -I./third_party/freertos/include \
  -L./lib \
  -T./linker.ld \
  main.c \
  startup.c \
  -lmcu \
  -lfreertos \
  -o firmware.elf

拆开来看：

• -mcpu=cortex-m4 -mthumb：目标架构选项
• -O2：发布级优化
• -g3：带宏定义的调试信息
• -Wall -Wextra -Werror：严格警告检查
• -I 三个路径：项目头文件、驱动头文件、FreeRTOS 头文件
• -L./lib：库文件路径
• -lmcu -lfreertos：链接 MCU 库和 FreeRTOS 库
• -T./linker.ld：链接脚本

这个命令基本覆盖了嵌入式开发中 90% 的场景。你可以在自己的项目中以此为模板，按需调整。

4.6 知识结构图

下面这张图总结了本章五个核心选项组的关系：