C++调用C库报undefined reference的根本原因是C++编译器对函数名进行name mangling，而C库导出的是未修饰的纯符号名，导致链接时无法匹配；解决方法是在C++中用extern "C"包裹头文件或声明，强制按C链接规则处理符号。
为什么C++直接调用C库会报“undefined reference”
因为C++编译器默认对函数名做name mangling（名字修饰），而C编译器生成的符号是未经修饰的纯函数名。链接时找不到匹配符号，就报undefined reference to 'xxx'错误。
解决办法不是改C库源码，而是在C++代码里用extern "C"告诉编译器：“接下来这部分声明，按C的方式处理符号”。
- 必须放在头文件包含之前，或包在
extern "C"块内 - 如果C库提供了自带的头文件（如
libfoo.h），优先检查它是否已内置#ifdef __cplusplus保护 —— 有的库已经自己做了兼容 - 若没有，你得自己包裹：
extern "C" { #include "libfoo.h" }
如何正确声明和使用C库中的指针类型与回调函数
C库常暴露函数指针类型（如typedef int (*callback_t)(int)）或接受指针参数（如void* user_data）。C++里直接传lambda或成员函数会失败，因为类型不兼容。
- 普通函数指针可以传：写一个
static或全局C风格函数作为胶水 - 不能直接传
std::function或lambda —— 它们不是C ABI兼容的指针类型 - 若需捕获状态，把数据塞进
void*参数，再在C回调里用static_cast转回原类型（确保生命周期足够长） - C头文件中若用
void*接收用户数据，C++侧传入对象地址时，务必确认该对象不会在回调触发前被析构
链接时提示“cannot find -lxxx”或运行时报“symbol lookup error”
这属于构建阶段问题，和extern "C"无关，但常被一起遇到。
立即学习“C语言免费学习笔记（深入）”；
- 确认库文件存在：
ls /usr/lib/libxxx.so或find /usr -name "libxxx.*" 2>/dev/null - 链接顺序重要：C++目标文件要放在
-lxxx之前，例如：g++ main.o -lfoo -o app，不能写成-lfoo main.o - 动态库路径未被识别？运行前设
LD_LIBRARY_PATH，或编译时加-Wl,-rpath,/path/to/lib - 32/64位混链会导致静默失败：用
file libfoo.so和file main.o核对架构是否一致
混合使用C标准库函数时要注意内存管理边界
比如C库用malloc分配内存并返回char*，C++代码不能用delete[]释放；反过来，C库若声明“用户负责释放”，且你用new分配了内存，也不能传给free()。
- 坚持“谁分配谁释放”原则，且分配/释放API必须来自同一套ABI（
malloc/free配对，new/delete配对） - 若C库文档写明“内部使用
malloc”，那你就必须用free()—— 即使你在C++里调用 - 封装一层RAII类时，析构函数里调用的释放函数必须严格匹配分配方式，否则可能崩溃或泄漏
C++调用C库真正麻烦的从来不是语法，而是ABI边界上那些看不见的约定：符号可见性、内存归属、调用栈清理责任、甚至结构体填充对齐。这些地方出错，往往没有编译警告，只有运行时崩得莫名其妙。
