library_path仅影响编译链接阶段，ld_library_path仅影响程序运行时；前者供gcc查找库进行链接，后者供动态加载器查找.so文件运行，二者语义、时机、用途完全不同，不可混用或替代。
LIBRARY_PATH 和 LD_LIBRARY_PATH 别混用
LIBRARY_PATH 仅影响 gcc / g++ 在链接阶段（link time）找静态库（.a）和共享库（.so）的路径；而 LD_LIBRARY_PATH 只在程序运行时（run time）生效，用于定位已编译好的可执行文件所依赖的动态库。
常见错误是把两者都设成同一路径却仍报 libxxx.so: cannot open shared object file —— 那说明链接成功了，但运行时没找到库。这时该查 LD_LIBRARY_PATH，不是 LIBRARY_PATH。
-
LIBRARY_PATH：设完后，gcc -lmylib就能直接链接，不用加-L -
LD_LIBRARY_PATH：设完后，./a.out才能顺利加载libmylib.so - 二者值可以相同，但语义和生效时机完全不同，不能互相替代
补充 lib 路径的三种实操方式（按优先级排序）
不是所有场景都适合改环境变量。优先选编译期硬编码路径，再考虑用户级环境变量，最后才是系统级配置。
- 编译时用
-L/path/to/lib -lmylib：最直接，不污染环境，适合单项目或 CI 构建 - 临时补充：
export LIBRARY_PATH=$LIBRARY_PATH:/opt/mylib+export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/mylib，然后source ~/.bashrc或当前 shell 生效 - 永久补充（仅限可信路径）：
echo "/opt/mylib" | sudo tee -a /etc/ld.so.conf.d/mylib.conf，再执行sudo ldconfig—— 注意：这步必须做，否则/etc/ld.so.cache不更新，运行时依然找不到
为什么 source ~/.bashrc 后 gcc 还是找不到库？
因为 gcc 查找库路径的顺序是：-L 参数 → LIBRARY_PATH → 系统默认路径（/usr/lib, /lib）。如果 LIBRARY_PATH 没生效，大概率是变量没导出或拼写错误。
- 检查是否漏了
export：写成LIBRARY_PATH=...（无 export）不会生效 - 检查变量名：是
LIBRARY_PATH，不是LD_LIBRARY_PATH或LIBPATH - 检查冒号分隔：多个路径用
:，不是空格或逗号；末尾不要多加冒号 - 验证方式：
echo $LIBRARY_PATH应输出完整路径；gcc -print-search-dirs | grep libraries会显示实际生效的库搜索路径
ldconfig 更新失败或不生效的典型原因
往 /etc/ld.so.conf.d/ 加路径后运行 sudo ldconfig 却没效果，通常不是命令错了，而是权限或路径本身有问题。
- 路径不存在或无读取权限：
ls -ld /opt/mylib确认目录存在且root可读 - 路径下没有真正的
.so文件：find /opt/mylib -name "*.so*"必须有匹配结果 - 误用软链接指向无效目标：ldconfig 不解析 symlink 的最终目标，只扫描真实目录内容
- 忘记加
.conf后缀：/etc/ld.so.conf.d/ 下的文件必须以.conf结尾，否则被忽略
真正容易被忽略的是：ldconfig 只缓存 .so 文件，不处理 .a；它只影响运行时，不影响链接时。所以静态库永远得靠 LIBRARY_PATH 或 -L。
