/bin/ld cannot find -lxxx 报错及解决方案

发表于 2017-12-21 分类于 linux 基础

今天编译软件的时候，遇到如下报错：

1 2	/bin/ld: cannot find -lsqlite3 collect2: error: ld returned 1 exit status

后来在网上查找到是与 gcc 的 - L 和 - l 选项有关，故搬运记录于此。

-l 和 - L 参数

gcc 编译代码时，-l 参数用来指定程序要链接的库，-l 参数紧接着就是库名。那么库名跟真正的库文件名有什么关系呢？就拿数学库来说，他的库名是 m，他的库文件名是 libm.so，很容易看出，把库文件名的头 lib 和尾.so 去掉就是库名了。

若需要使用第三方库 libtest.so，那么只要把 libtest.so 拷贝到 /usr/lib 里，编译时加上 - ltest 参数，就能用上 libtest.so 库了（当然要用 libtest.so 库里的函数，我们还需要与 libtest.so 配套的头文件）。

放在 /lib 和 /usr/lib 和 /usr/local/lib 里的库直接用 - l 参数就能链接了，但如果库文件没放在这三个目录里，而是放在其他目录里，这时我们只用 - l 参数的话，链接就会出错，出错信息大概是：“/usr/bin/ld: cannot find -lxxx”，也就是链接程序 ld 在那 3 个目录里找不到 libxxx.so，这时另外一个参数 - L 就派上用场了，比如常用的 X11 的库，它在 /usr/X11R6/lib 目录下，我们编译时就要用 - L/usr/X11R6/lib -lX11 参数，-L 参数跟着的是库文件所在的目录名。再比如我们把 libtest.so 放在 /aaa/bbb/ccc 目录下，那链接参数就是 - L/aaa/bbb/ccc -ltest。

另外，大部分 libxxxx.so 只是一个链接，以 RH9 为例，比如 libm.so 它链接到 /lib/libm.so.x，/lib/libm.so.6 又链接到 /lib/libm-2.3.2.so，如果没有这样的链接，还是会出错，因为 ld 只会找 libxxxx.so，所以如果你要用到 xxxx 库，而只有 libxxxx.so.x 或者 libxxxx-x.x.x.so，做一个软链接就可以了 ln -s libxxxx-x.x.x.so libxxxx.so。

手工来写链接参数总是很麻烦的，还好很多库开发包提供了生成链接参数的程序，名字一般叫 xxxx-config，一般放在 /usr/bin 目录下，比如 gtk1.2 的链接参数生成程序是 gtk-config，执行 gtk-config --libs 就能得到以下输出 "-L/usr/lib -L/usr/X11R6/lib -lgtk -lgdk -rdynamic -lgmodule -lglib -ldl -lXi -lXext -lX11 -lm"，这就是编译一个 gtk1.2 程序所需的 gtk 链接参数，xxx-config 除了 --libs 参数外还有一个参数是 --cflags 用来生成头文件包含目录的，也就是 - I 参数，在下面我们将会讲到。你可以试试执行 gtk-config --libs --cflags，看看输出结果。

现在的问题就是怎样用这些输出结果了，最笨的方法就是复制粘贴或者照抄，聪明的办法是在编译命令行里加入这个选项：

`xxxx-config --libs --cflags` 

比如编译一个gtk程序：

gcc gtktest.c `gtk-config --libs --cflags`

注意`不是单引号，而是1键左边那个键。

-include 和 - I 参数

-include 用来包含头文件，但一般情况下包含头文件都在源码里用 #include xxxxxx 实现，所以 - include 参数很少用。-I 参数是用来指定头文件目录，/usr/include 目录一般是不用指定的，gcc 知道去那里找，但是如果头文件不在 /usr/include 里我们就要用 - I 参数指定了，比如头文件放在 /myinclude 目录里，那编译命令行就要加上 - I/myinclude 参数了，如果不加你会得到一个 "xxxx.h: No such file or directory" 的错误。-I 参数可以用相对路径，比如头文件在当前目录，可以用 - I. 来指定。

C++ 2011 报错

有时会遇到如下报错#error This file requires compiler and library support for the ISO C++ 2011 standard. This support is currently experimental, and must be enabled with the -std=c++11 or -std=gnu++11 compiler options. 只需要在编译程序之前运行 CXX="g++ -std=c++11" 即可。

ldd 命令

当服务器上多台电脑使用不同的操作系统时，有时会遇到找不到对应版本的库文件的问题。此时，需要使用 ldd 命令查找出缺失的库文件名称，然后可以利用 locate 命令搜索所需库文件的位置，再通过软链接将相应版本的库文件链接到合适的位置。

ldd 命令用于判断某个可执行的二进制含有什么动态函式库。eg:

1
2
3

ldd /bin/ls  

strings /lib64/libc.so.6 | grep GLIBC

locate 命令其实是 “find -name” 的另一种写法，但是要比后者快得多，原因在于它不搜索具体目录，而是搜索一个数据库（/var/lib/locatedb）。这个数据库中含有本地所有文件信息。Linux 系统自动创建这个数据库，并且每天自动更新一次，所以使用 locate 命令查不到最新变动过的文件。为了避免这种情况，可以在使用 locate 之前，先使用 updatedb 命令，手动更新数据库。

Source: - gcc -l 参数和 - L 参数

-l 和 - L 参数

-include 和 - I 参数

相关环境变量

C++ 2011 报错

ldd 命令