代码写得没问题，一编译却蹦出一堆undefined reference to xxx。改了半天，最后发现是命令里库的顺序写反了。今天把 GCC 语法、核心参数、多参数组合，以及最容易踩的链接顺序坑，一篇讲清。
一、gcc 基本语法
一条 gcc 命令长这样：
$ gcc[options][source files][object files][-o output file]四部分：选项（options）、源文件、目标文件、输出文件。不写-o时，默认生成a.out。
提醒：GCC 是GNU Compiler Collection的缩写，不止能编 C，C++ / Fortran 等都行。我们常说的
gcc默认走 C 编译。
二、核心参数速查
| 分类 | 参数 | 作用 |
|---|---|---|
| 编译控制 | -c | 只编译不链接，生成 .o 目标文件 |
| 预处理 | -Dname[=value] | 定义宏（等价于源码#define） |
-Uname | 取消宏定义 | |
| 路径 | -I dir | 头文件（header）搜索目录 |
-L dir | 库文件（library）搜索目录 | |
| 链接 | -l lib | 链接指定库（如-lm链 libm） |
| 输出 | -o file | 指定输出文件名 |
| 优化 | -O level | 优化代码（O0/O1/O2/O3/Os） |
| 调试 | -g level | 生成 GDB 调试信息（g1/g/g3） |
| 共享库 | -fPIC | 生成位置无关代码（Position Independent Code） |
-shared | 生成共享库 .so | |
| 警告 | -w | 关闭所有警告 |
-Wall | 开启全部常用警告 | |
-Wextra | 在 -Wall 基础上再加额外警告 |
分级速记：
- 优化
-O：-O0不优化（默认）｜-O2常用｜-O3激进｜-Os省体积 - 调试
-g：-g1最少｜-g常规｜-g3最全（含宏） - 警告：
-w（压制）→ 默认 →-Wall→-Wextra
三、多参数命令
多数参数与顺序无关，空格分隔即可：
# 优化 + 全警告 + 自定义名gcc-O2-Wall-oapp main.c utils.c# 可调试 + 暴露隐患（开发期标配）gcc-g-Wall-oapp main.c# 做共享库：位置无关 + 共享，固定搭配gcc-fPIC-shared-olibfoo.so foo.c# 引入第三方库：头文件目录 + 库目录 + 链接库gcc-O2-Wall-I/opt/include -L/opt/lib-lmylib-oapp main.c# 定义宏 + 优化gcc-DDEBUG-O2-oapp main.c实战组合：开发期用
-g -Wall，发布期用-O2 -Wall，做 SDK / 插件用-fPIC -shared。
四、注意：-l 链接顺序
很多人栽在这。-l链接库有依赖顺序：被依赖的库写在后面。
链接器（linker）从左到右只扫一遍，静态库（.a）只在「能补上当前未定义符号」时才被拉入，不会回头补救左侧的依赖。由此两条铁律：
- 目标文件（.o）写在库之前：
gcc app.o -lfoo，别写gcc -lfoo app.o - 若 A 依赖 B（A 调用 B），写
-lA -lB——等 A 暴露出对 B 的需求时，B 还在右侧可被拉入
依赖链app → foo → bar（app 调 foo，foo 调 bar）：
| 命令 | 结果 | 原因 |
|---|---|---|
gcc app.o -lfoo -lbar | 成功 | app 暴露 foo 需求→拉 foo→foo 暴露 bar 需求→右侧 bar 补上 |
gcc -lfoo -lbar app.o | 失败 | 处理库时 app 还没出现，两库被整体跳过，报undefined reference |
gcc app.o -lbar -lfoo | 失败 | foo 排在 bar 之后，需要的 bar 已错过，报undefined reference to bar |
进阶：
- 循环依赖（A↔B）单遍无解，用分组循环扫描：
-Wl,--start-group -lA -lB -Wl,--end-group - 共享库（.so）符号在运行时由动态链接器解析，顺序相对宽松；但发行版默认
--as-needed，链接期顺序仍影响DT_NEEDED记录，好习惯照旧
踩坑细节：
-l和库名之间不能有空格，写-lm，不写-l m。
五、参数别乱加
-O3不一定更快：激进内联会撑大代码、拖慢指令缓存命中，嵌入式 / 实时场景慎用，-O2更稳。-static静态链接：可执行文件体积暴涨、无法享受系统库更新，除非要的是可移植单文件。-w关警告：等于蒙眼开车，开发期别用，至少上-Wall。-g进发布版：带调试信息体积大且暴露源码结构，发布时去掉或单独分离。
结尾
GCC 高频参数就这些，记住「分类 + 组合 + 链接顺序」三件事，编译报错能少一大半。
参考资料：https://www.rapidtables.com/code/linux/gcc.html
