编译提示“library not found”本质是链接器未搜索自定义库路径，而非库未安装；需在编译阶段显式指定-l和-rpath固化路径，避免依赖ld_library_path或系统全局配置。
编译时提示“library not found”但库明明已安装
这不是库没装，而是链接器根本没去你装的地方找。Linux/macOS/麒麟等系统默认只查/lib、/usr/lib（或/usr/lib64），而源码编译的库通常落在/usr/local/lib、/opt/mylib这类路径，不显式告诉系统，它就当不存在。
常见现象包括：ld: library not found for -lssl（macOS）、cannot find -lz（Linux）、error while loading shared libraries: libxxx.so.1: cannot open shared object file（运行时报）。
- 先用
find /usr -name "libssl.so*" 2>/dev/null或brew --prefix openssl确认库实际位置 - 不要依赖
LD_LIBRARY_PATH临时设置——它只影响运行时，且在 macOS 上受 SIP 限制、在现代 Linux 上被部分程序忽略 - 优先在编译阶段就把路径“焊死”：configure 时加
--with-ld-opt="-L/opt/openssl/lib -Wl,-rpath,/opt/openssl/lib"，CMake 时设-DCMAKE_INSTALL_RPATH=/opt/openssl/lib
macOS 上 dyld 加载了错误版本的同名库
报错说Symbol not found: _SSL_CTX_set_ciphersuites或GLIBCXX_3.4.29 not found，本质不是缺库，而是 dyld 加载了系统自带的旧版libssl.dylib或 x86_64 版本的libstdc++.so，而你的程序需要 ARM64 + 新 ABI。
验证方法必须分两步：otool -L your_binary看编译时记录的路径，再用dyld_print_libs=1 ./your_binary 2>&1 | grep ssl看运行时真实加载路径——两者常不一致。
- Homebrew 安装的库（如
libiconv）和系统/usr/lib/libiconv.dylib同名但 ABI 不兼容，dyld 优先选后者 - M1/M2/M3 用户务必确认终端是 ARM64 模式（Activity Monitor 查进程架构），否则 clang 会拉 x86_64 工具链，导致混链
- 修复用
install_name_tool -change /usr/lib/libssl.dylib @rpath/libssl.dylib your_binary，再用install_name_tool -add_rpath /opt/homebrew/opt/openssl/lib your_binary
麒麟/统信等国产系统动态库路径未注册
银河麒麟 V10 默认不扫描/usr/local/lib，哪怕你把 OpenCV 编译好装进去了，ldd照样报not found——因为ldconfig压根没把它加入缓存。
关键动作只有三步，缺一不可：sudo nano /etc/ld.so.conf → 末尾新增/usr/local/lib（顶格、无空格、无斜杠结尾）→ sudo ldconfig。
- 别写成
/usr/local/lib/——末尾斜杠会导致路径解析失败 - 改完后用
sudo ldconfig -p | grep local确认该路径已出现在缓存列表中 - 若需为单个程序绑定专属路径，用
patchelf --set-rpath '/usr/local/lib:/opt/dep/lib' ./myapp，比改系统配置更安全
交叉编译时工具链与目标库路径错位
在 WSL 或 Docker 中交叉编译鸿蒙/ARM 程序，报cannot find crt1.o或undefined reference to `pthread_cancel'，往往不是缺文件，而是构建系统在主机路径里找目标平台库。
典型陷阱：WSL 共享目录下脚本含\r\n换行符，导致CROSS_COMPILE=arm-linux-gnueabihf-变量被截断；或 musl libc 下误调 glibc 特有函数。
- 用
file HPKBUILD确认脚本是 Unix 格式（output 含with CRLF line terminators则需修复） - 交叉编译必须显式指定
--sysroot=/path/to/sysroot，且 sysroot 目录结构要完整（lib/、usr/lib/、include/全得有） - 遇到
pthread_cancel报错，检查是否定义了__MUSL__宏，用#if !defined(__OHOS__) && !defined(__MUSL__)条件屏蔽非 POSIX 函数
-L和-rpath一起带上，让路径从生成那一刻就固化进去——别指望运行时靠环境变量或系统全局配置来救。
