最常见报错是“multiple definition of `xxx'”，如file1.o和file2.o均定义了config_flag；根源是头文件中误写变量/函数定义、多源文件实现同名非static函数、静态库混用或同一源文件重复编译。
重复定义错误的典型报错长什么样
最常见的是 multiple definition of `xxx'，后面跟着一堆 .o 文件路径和偏移地址。比如：
file1.o:(.data+0x0): multiple definition of `config_flag' file2.o:(.bss+0x4): first defined here collect2: error: ld returned 1 exit status
这说明 config_flag 在 file1.o 和 file2.o 中都被定义了（不是声明），链接器拒绝合并。
为什么静态库里会出现重复定义
静态库本身不“包含”其他库代码，但多个源文件可能误写了同名全局变量或函数定义——尤其在头文件里直接写 int global_var = 0; 而非 extern int global_var;，再被多个 .c 包含，就等于每个编译单元都定义了一次。
- 头文件中写了变量/函数定义（而非仅声明）
- 多个
.c文件各自实现了同名非static函数 - 打包进静态库的多个
.o文件来自不同分支、未同步的代码，意外引入重复实现 - 构建时混用了不同版本的同一库（如
libutils_v1.a和libutils_v2.a），二者都导出了init_logger()
快速定位哪个文件在重复定义
用 nm 查看符号类型，重点关注 T（全局函数）、D（已初始化全局变量）、B（未初始化全局变量）：
nm -C libA.a | grep ' config_flag\|init_logger'
如果看到同一符号在多个 .o 中都标为 D 或 T，就是冲突源。再结合 ar -t libA.a 列出成员文件，逐个查。
-
nm -C libA.a | grep ' T '找所有全局函数定义 -
objdump -t libA.a | grep GLOBAL看更详细的符号表 - 若发现某个
.o里有U（undefined）引用但没定义，说明它依赖外部，不是冲突方
真正有效的修复方式，不是加 --allow-multiple-definition
这个链接选项只是掩盖问题：g++ -Wl,--allow-multiple-definition 会让链接器取第一个遇到的定义，但无法保证语义正确——比如两个库对 log_init() 的初始化逻辑不同，强制用前者可能导致后者功能失效。
- 把头文件里的变量定义改成
extern声明，只在一个.c里定义 - 给库内函数加
static限定作用域，或使用__attribute__((visibility("hidden")))编译 - 用
objcopy --localize-symbol=xxx把冲突符号转为局部符号（仅适用于你可控的库） - 检查 CMake 或 Makefile，确认没有重复
add_library或重复target_sources
最容易被忽略的是：同一个源文件被多次编译进不同 .o，然后一起塞进静态库——ar 不去重，链接器照单全收。
