gcc/g++中-l（小写L）参数的含义及相关技术疑问

云上老周

2026-7-28

gcc/g++ 中 -l（小写L）参数完全解析

基本含义

-l是gcc/g++用来指定要链接的库的核心参数，作用是告诉链接器去搜索并关联指定的库文件，比如你提到的-lm就是关联数学库，让代码能调用math.h里的函数。

实际操作：当你写-lxxx时，gcc会把这个参数转给链接器ld，ld会在预设的搜索路径里查找名为libxxx.a（静态库）或libxxx.so（动态库）的文件，然后将找到的库与你的目标文件链接整合。比如-lm就是找libm.a或libm.so，把数学库的代码（或动态链接引用）加入最终可执行文件。
和手动指定的区别：
- -I是给编译器用的，用来指定头文件搜索路径，让编译器找到.h文件；直接写.a文件路径是强制链接器使用这个具体的静态库文件。
- -lxxx是让链接器自主在预设路径里匹配对应库，无需写全路径、前缀lib和后缀.a/.so，更简洁。且默认优先选择动态库，手动指定.a则只能用静态库。
-lgtest的前置条件：
- 系统已安装Google Test库，且libgtest.a/libgtest.so在ld的预设搜索路径（如/usr/lib、/usr/local/lib），或你用-L参数指定了库的额外存放路径；
- 头文件gtest/gtest.h能被编译器找到（要么在默认头文件路径，要么用-I指定头文件目录）。

没错，l就是library的缩写。
这个参数最终是传递给链接器ld的——gcc作为编译前端工具，会对参数分类，将链接相关的参数（包括-l、-L等）转交给ld处理。你可以用gcc -v编译代码，就能看到实际传给ld的命令里包含-lxxx。

-lpthread仅做链接层面操作：告诉链接器去链接libpthread.so/libpthread.a库；
-pthread是gcc的综合参数，会同时完成两件事：一是给编译器传递编译标志（比如定义_REENTRANT宏，让标准库函数变为线程安全版本），二是告诉链接器链接pthread库。写多线程代码时优先用-pthread，避免只链接库但编译时未开启线程安全支持的问题。

默认情况下，ld会优先选择动态库（.so），找不到动态库才会使用静态库（.a）。如果要强制链接静态库，可以加-static参数，或者用-l:libxxx.a的形式指定具体静态库（注意冒号不能省略）。
库的默认搜索路径包括/usr/lib、/usr/local/lib、/lib等，你可以用ld --verbose | grep SEARCH_DIR命令查看ld的完整搜索路径列表。也可以用-L/path/to/libs参数添加额外的搜索路径。

ldconfig是维护系统动态库缓存的工具，它会扫描/etc/ld.so.conf和/etc/ld.so.conf.d/里配置的路径，把找到的动态库信息存入/etc/ld.so.cache。ld在搜索动态库时，会优先从这个缓存里查找（比直接遍历目录更快）。
当你安装新的动态库后，运行sudo ldconfig -v可以更新缓存，让ld能找到新库，这样-lxxx就能正常链接到新库。ldconfig -v的输出会列出它扫描到的所有动态库，这些就是-l参数能找到的动态库的一部分。

完全可以，只需按规则命名你的库并让ld能找到它：
1. 将你的库文件命名为libxxx.a（静态库）或libxxx.so（动态库），前缀必须是lib；
2. 把库所在路径加入ld的搜索路径：要么把库放到/usr/lib这类默认路径，要么用-L/path/to/your/lib参数指定额外路径；
3. 之后就能用-lxxx来链接你的自定义库了。
示例：你编译了自己的静态库libmylib.a放在./mylibs目录下，编译命令可写：gcc main.c -o main -L./mylibs -lmylib，这样ld就会找到./mylibs/libmylib.a并链接它。

内容的提问来源于stack exchange，提问作者Gabriel Staples