linux下C/C++编译时系统搜索 include 和链接库文件路径的指定

最新推荐文章于 2025-10-29 18:59:19 发布

原创最新推荐文章于 2025-10-29 18:59:19 发布 · 3.4w 阅读

51 ·

CC 4.0 BY-SA版权

文章标签：

#C++ #c #gcc #linux #库

C/C++ 专栏收录该内容

7 篇文章

订阅专栏

本文介绍在Linux环境下配置C/C++程序的include头文件和link库文件路径的方法，包括通过环境变量和配置文件等方式，并解释了这些配置对程序编译及运行的影响。

C/C++程序在linux下被编译和连接时，GCC/G++会查找系统默认的include和link的路径，以及自己在编译命令中指定的路径。自己指定的路径就不说了，这里说明一下系统自动搜索的路径。

【1】include头文件路径

除了默认的/usr/include, /usr/local/include等include路径外，还可以通过设置环境变量来添加系统include的路径：

# C

export C_INCLUDE_PATH=XXXX:$C_INCLUDE_PATH

# CPP

export CPLUS_INCLUDE_PATH=XXX:$CPLUS_INCLUDE_PATH

以上修改可以直接命令行输入（一次性），可以在/etc/profile中完成（对所有用户生效），也可以在用户home目录下的.bashrc或.bash_profile中添加（针对某个用户生效），修改完后重新登录即生效。

【2】link链接库文件路径

链接库文件在连接（静态库和共享库）和运行（仅限于使用共享库的程序）时被使用，其搜索路径是在系统中进行设置的（也可以在编译命令中通过 -l -L 来指定，这里讲的是使用系统默认搜索路径）。

一般 Linux 系统把 /lib /usr/lib /usr/local/lib 作为默认的库搜索路径，所以使用这几个目录中的链接库文件可直接被搜索到（不需要专门指定链接库路径）。对于默认搜索路径之外的库，则需要将其所在路径添加到gcc/g++的搜索路径之中。

链接库文件的搜索路径指定有两种方式：1）修改/etc/so.ld.conf 2）修改环境变量，在其中添加自己的路径

1）在环境变量中添加

动态链接库搜索路径：

export LD_LIBRARY_PATH=XXX:$LD_LIBRARY_PATH

静态链接库搜索路径：

export LIBRARY_PATH=XXX:$LIBRARY_PATH

以上修改可以直接命令行输入（一次性），可以在/etc/profile中完成（对所有用户生效），也可以在用户home目录下的.bashrc或.bash_profile中添加（针对某个用户生效）,修改完后重新登录即生效。

2）在/etc/ld.so.conf 中添加指定的链接库搜索路径（需要root权限），然后运行 /sbin/ldconfig，以达到刷新 /etc/ld.so.cache的效果。

以上两种方式均可以达到指定链接库搜索路径的效果。

第二种搜索路径的设置方式对于程序连接时的库（包括共享库和静态库）的定位已经足够了，但是对于使用了共享库的程序的执行还是不够的。这是因为为了加快程序执行时对共享库的定位速度，避免使用搜索路径查找共享库的低效率，系统会直接读取 /etc/ld.so.cache 并从中进行搜索的。/etc/ld.so.cache 是一个非文本的数据文件，不能直接编辑，它是根据 /etc/ld.so.conf 中设置的搜索路径由 /sbin/ldconfig 命令将这些搜索路径下的共享库文件集中在一起而生成的（ldconfig 命令要以 root 权限执行）。因此，为了保证程序执行时对库的定位，在 /etc/ld.so.conf 中进行了库搜索路径的设置之后，还要运行 /sbin/ldconfig 命令，更新 /etc/ld.so.cache 文件。

ldconfig的作用就是将/etc/ld.so.conf 指定的路径下的库文件缓存到/etc/ld.so.cache 。因此当安装完一些库文件(例如刚安装好glib)，或者修改ld.so.conf增加新的库路径后，需要运行一下/sbin/ldconfig 使所有的库文件都被缓存到ld.so.cache中，不然修改的内容就等于没有生效。

在程序连接时，对于库文件（静态库和共享库）的搜索路径，除了上面的设置方式之外，还可以通过 -L 和 -l 参数显式指定。因为用 -L 设置的路径将被优先搜索，所以在连接的时候通常都会以这种方式直接指定要连接的库的路径。

注意：

1）在配置环境变量的时候，等号前面不要加空格，否则可能出现 command not found

2）修改/etc/ld.so.conf后，当系统重新启动后，所有基于 GTK2 的程序在运行时都将使用新安装的 GTK+ 库。由于 GTK+ 版本的改变，有时会给应用程序带来兼容性的问题，造成某些程序运行不正常。为了避免出现这些情况，在 GTK+ 及其依赖库的安装过程中对于库的搜索路径的设置将采用环境变量的方式
export LD_LIBRARY_PATH=/opt/gtk/lib:$LD_LIBRARY_PATH

2014.03.18

allenlinrui