最常见情况是编译通过但运行时报错“error while loading shared libraries: libxxx.so: cannot open shared object file”，根本原因是动态链接器默认仅搜索/lib、/usr/lib等系统路径，而未找到用户自定义路径下的库；可通过export LD_LIBRARY_PATH临时添加路径，或写入/etc/ld.so.conf.d/并执行sudo ldconfig永久生效，亦可使用-Wl,-rpath,'$ORIGIN'在编译时嵌入运行时搜索路径。
gcc链接动态库时找不到libxxx.so
最常见的情况是编译能过，但运行时报错：./main: error while loading shared libraries: libxxx.so: cannot open shared object file: No such file or directory。这不是编译问题，而是运行时动态链接器找不到库文件。
根本原因：动态库在编译阶段只检查符号声明（头文件），真正加载发生在程序启动时，由ld-linux-x86-64.so.2等动态链接器负责——它默认只查/lib、/usr/lib、/usr/local/lib这些系统路径。
- 临时解决：用
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your/lib/path把你的.so所在目录加进去（注意：该变量只对当前 shell 及其子进程有效） - 永久生效（推荐用于开发机）：把路径写入
/etc/ld.so.conf.d/mylib.conf，再执行sudo ldconfig - 不改环境也不动系统配置？直接复制库到
/usr/local/lib后运行sudo ldconfig也行
gcc命令里加-lxxx却提示cannot find -lxxx
这是编译链接阶段就失败，说明gcc在找libxxx.so时压根没搜到。注意：-lxxx会自动展开为查找libxxx.so（优先）或libxxx.a（除非加了-static）。
关键点在于-L参数的位置和含义：它只影响**紧随其后**的-l选项，且不能带空格。比如gcc main.c -L./ -lxxx -o main是对的；而gcc main.c -L ./ -lxxx（中间有空格）或gcc main.c -lxxx -L./（顺序颠倒）都会失败。
- 确认
libxxx.so真在-L指定的目录下，用ls ./libxxx.so验证 - 检查文件权限：
libxxx.so必须有可读（r）权限，否则链接器静默跳过 - 如果库名带版本号（如
libxxx.so.1.2），要确保存在未带版本号的软链接：ln -sf libxxx.so.1.2 libxxx.so
为什么加了-L和-l还是链接到了系统里的旧版libxxx.so
因为gcc默认按固定顺序搜索路径：-L路径 → /usr/lib/x86_64-linux-gnu → /usr/lib → /lib。如果你的-L./路径下只有libxxx.so，但系统/usr/lib里有同名的libxxx.so.0，链接器仍可能选后者——尤其当你的.so没导出正确符号或版本不匹配时。
验证实际链接了哪个库：编译后立即执行ldd ./main | grep xxx，看输出的路径是否符合预期。
- 强制使用指定路径下的库：用
-Wl,-rpath,'$ORIGIN'（运行时从可执行文件所在目录找）或-Wl,-rpath,/your/lib/path -
$ORIGIN是特殊标记，表示可执行文件自身所在目录，比LD_LIBRARY_PATH更可控，也避免污染环境变量 - 注意单引号：防止 shell 提前展开
$ORIGIN，应写作'$ORIGIN'
生成动态库时忘记-fPIC会怎样
如果源码编译成.o时没加-fPIC，后续用gcc -shared生成.so会报错：relocation R_X86_64_32 against `.rodata' can not be used when making a shared object。这是因为动态库必须能在内存任意地址加载，所有代码得是位置无关的。
修复方式不是重装系统或换编译器，而是回退一步：重新编译目标文件。
- 正确流程：先
gcc -fPIC -c xxx.c -o xxx.o，再gcc -shared xxx.o -o libxxx.so - 也可以一步到位：
gcc -fPIC -shared xxx.c -o libxxx.so（省略中间.o） - 如果已有非
-fPIC的.o，不能复用——必须删掉重编，ar或gcc -shared都不会帮你转成 PIC
-rpath和$ORIGIN的组合——它让程序自带“找库地图”，不依赖外部环境变量，部署时最稳。 
