根本原因是链接器未找到库路径，需用-l指定目录、-l指定库名，且-l必须在-l前；静态库依赖需按调用顺序排列；c++调c库须用extern "c"；动态库运行时需ld_library_path或-rpath。
链接时找不到 libxxx.a 或 libxxx.so
根本原因通常是链接器压根没看到库文件路径，不是“写法错”，而是“路没指对”。g++ 默认只在系统标准路径（如 /usr/lib）里找库，你自己放的库得手动告诉它在哪。
- 用
-L/path/to/lib告诉链接器去哪找库文件（注意是目录路径，不是 .a/.so 文件本身） - 用
-lxxx告诉它要链哪个库（libxxx.a或libxxx.so，自动忽略lib前缀和后缀） -
-L必须写在-l之前，顺序反了会失效 - 静态库和动态库同名时（比如都有
libmath.a和libmath.so），g++默认优先选.so；加-static才强制走.a
undefined reference to 'xxx' 但头文件明明包含了
这是最典型的“声明有、定义无”问题。包含头文件只让编译器知道函数长啥样，不等于把实现代码塞进最终可执行文件里。
- 确认你链接的库确实提供了这个符号：用
nm -C libxxx.a | grep xxx（静态库）或nm -D libxxx.so | grep xxx（动态库）查一下 - 如果库是 C 写的，而你在 C++ 里调，函数声明必须包在
extern "C"里，否则 C++ 名字修饰（name mangling）会让链接器找不到 - 静态库之间有依赖时（比如
libA.a调用了libB.a的函数），链接命令里libA必须写在libB前面，或者重复写一遍：-lA -lB -lA
运行时报错 error while loading shared libraries: libxxx.so: cannot open shared object file</H3>
<p>编译链接成功 ≠ 运行成功。动态库在运行时才加载，系统得能现场找到它。</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/ai/1021" title="FreeTTS"><img
src="https://img.php.cn/upload/ai_manual/000/000/000/175680027061641.png" alt="FreeTTS" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/ai/1021" title="FreeTTS">FreeTTS</a>
<p>FreeTTS是一个免费开源的在线文本到语音生成解决方案，可以将文本转换成MP3，</p>
</div>
<a href="/ai/1021" title="FreeTTS" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
<ul>
<li>临时解决：运行前设 <code>LD_LIBRARY_PATH=/path/to/lib:$LD_LIBRARY_PATH（仅限开发调试）
/usr/local/lib 或 /usr/lib，然后跑 sudo ldconfig 刷新缓存-Wl,-rpath,/path/to/lib 把运行时搜索路径硬编码进可执行文件（-Wl, 表示把后面参数传给链接器）-rpath ./lib），运行时工作目录一变就失效静态库更新后程序没生效，动态库更新后还是旧行为
静态库在编译时已全部塞进可执行文件，改了库源码不重新编译链接，旧二进制完全不受影响；动态库则相反——只要没重启进程，它就一直用加载进内存的老版本。
立即学习“C++免费学习笔记（深入）”；
- 改了静态库？必须重新
g++ ... -lxxx链接一次，哪怕只改了一个函数 - 改了动态库？先
kill掉正在用它的进程，再替换.so文件，否则ldd看起来是新路径，实际运行的还是旧映射 - 用
lsof -p PID | grep xxx可确认某进程当前加载的是哪个物理文件
extern "C" —— 这三处出问题时，现象都像“函数明明写了却用不了”，但根因完全不同，得一层层剥开看。 
