clang++ -shared 编译动态库时找不到符号的直接原因是源文件中函数仅有声明而无实现，或实现文件未参与编译；链接可执行文件时报“undefined reference”是因未指定库路径（-L.）和库名（-lrandom），运行时报“cannot open shared object file”则因LD_LIBRARY_PATH未设置或未用-rpath嵌入路径。
clang++ -shared 编译动态库时找不到符号
直接原因是源文件里声明了函数但没实现，或者实现文件没参与编译。Clang 不像 GCC 那样默认容忍部分未定义符号——-shared 生成动态库时，所有导出符号必须有定义（除非用 __attribute__((visibility("default"))) 显式控制且实际存在）。
- 检查
get_random_number()这类函数是否在random.cpp中有完整实现，不只是头文件声明 - 确认编译命令中包含所有实现文件：
clang++ -c random.cpp -o random.o，不能漏掉任何 .cpp - 如果用了模板或内联函数，它们必须在头文件中定义，否则链接时会“消失”
链接可执行程序时报 undefined reference to 'xxx'
这不是动态库本身的问题，而是主程序链接阶段找不到动态库里的符号。常见于两个环节断开：编译器不知道去哪找库，或运行时加载器压根没看到它。
Clang 22.1.3
下载
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
- 编译时加
-L.指定库路径，再加-lrandom（注意不是-llibrandom.so） - 确保
librandom.so真的在当前目录，且权限可读：ls -l librandom.so - 别跳过
ldd ./main—— 如果输出里librandom.so => not found，说明运行时路径没设对
运行时报 cannot open shared object file
编译成功 ≠ 能跑。Linux 动态链接器 ld.so 默认只查 /lib、/usr/lib 和 /etc/ld.so.conf 里配置的路径，不会自动扫当前目录。
- 临时解决：运行前执行
export LD_LIBRARY_PATH=.:$LD_LIBRARY_PATH - 长期方案：把
librandom.so放到/usr/local/lib，然后运行sudo ldconfig - 最稳妥：编译时嵌入路径，加链接选项
-Wl,-rpath,.（注意逗号后不能有空格）
nm -D 查不到导出函数？
Linux 上动态库默认导出所有非 static 符号，但 Clang 有时会因优化或 visibility 设置隐藏它们。这不是链接失败的直接原因，但会让调试变难。
- 用
nm -D librandom.so | grep get_random确认符号是否存在且带T（全局函数）或D（全局变量）标记 - 若无输出，检查是否误加了
-fvisibility=hidden；加-fvisibility=default强制导出 - 避免在头文件里用
static inline定义函数——它不会出现在动态库符号表中
ldd 和 nm -D 这两个命令要养成习惯性敲一遍，比反复改 CMakeLists.txt 快得多。 
