必须运行 sudo ldconfig 才能使 /etc/ld.so.conf 修改生效，否则系统仍用旧缓存；路径需写入 /etc/ld.so.conf.d/ 下的 .conf 文件，库须符合 libxxx.so.x 命名且含有效 soname。
直接改 /etc/ld.so.conf 为什么经常不生效？
因为改完文件本身不会触发任何动作——ld.so.conf 只是配置源，真正起作用的是缓存文件 /etc/ld.so.cache。这个缓存由 ldconfig 命令生成，不手动运行它，系统永远读不到你新加的路径。
常见错误现象：./a.out: error while loading shared libraries: libxxx.so: cannot open shared object file，但你确认库就在刚加的目录里。
- 必须用
sudo ldconfig（普通用户权限不够） - 建议加
-v参数验证是否扫描到了你的路径：sudo ldconfig -v 2>&1 | grep your_path - 如果路径下有库却没被列出来，检查：库文件权限是否至少为
rx、是否为 ELF 格式（file libxxx.so）、架构是否匹配（比如 x86_64 库不能用于 arm64 系统）
往 /etc/ld.so.conf 里写什么？格式有哪些硬限制？
只写绝对路径，一行一个，不能带空格、通配符、注释符号 #，也不能写具体库名或变量（比如 $HOME/lib 或 /home/user/lib 是无效的）。
例如正确写法：
/usr/local/lib64 /opt/myapp/lib
错误写法示例：
-
/usr/local/lib/*.so（通配符不支持） -
# /mylib（#不是注释，会被当路径一部分） -
$LD_LIBRARY_PATH/mylib（变量不展开） -
/home/user/lib（非标准位置，系统级链接器默认不信任）
为什么更推荐用 /etc/ld.so.conf.d/ 而不是直接改 /etc/ld.so.conf？
因为 /etc/ld.so.conf 通常只有一行：include /etc/ld.so.conf.d/*.conf，所有 .conf 文件都会被自动加载，管理更清晰、卸载更安全。
实操建议：
- 新建独立配置文件：
sudo tee /etc/ld.so.conf.d/myapp.conf - 文件名必须以
.conf结尾，否则不会被读取 - 多个应用可各建一个文件，比如
mysql.conf、python3.12.conf，互不干扰 - 卸载时只需删掉对应
.conf文件 + 运行一次sudo ldconfig
LD_LIBRARY_PATH 和 ld.so.conf 冲突时谁赢？
LD_LIBRARY_PATH 优先级更高，但它只影响当前 shell 及其子进程，且对 setuid 程序（如 sudo、passwd）完全无效。
部署场景必须注意：
- systemd 服务、crond 定时任务、GUI 应用启动器都看不到
LD_LIBRARY_PATH，必须走ld.so.conf.d+ldconfig - 混合使用时，同名库会按优先级覆盖：比如
LD_LIBRARY_PATH里有libssl.so.3，就会跳过ld.so.conf中同名版本，可能引发 ABI 不兼容 - 调试阶段可用
LD_LIBRARY_PATH=/path/to/lib ./myapp快速验证；上线前务必切回系统级配置
最常被忽略的点：哪怕路径已写入 .conf 文件，只要没运行 sudo ldconfig，ldd ./myapp 就查不到新库，ldconfig -p | grep xxx 也永远为空——这不是配置问题，是缓存没刷新。
