C++调用C函数链接失败主因是name mangling，需用extern "C"包裹C头文件声明；参数须为C兼容类型；链接时注意库顺序、架构匹配及运行时依赖。
为什么直接#include C头文件会链接失败
因为C++编译器默认对函数名做name mangling（名称修饰），比如把 void init() 编译成类似 _Z4initv 的符号；而C编译器生成的是未修饰的 init。链接器找不到匹配符号，报 undefined reference to 'init'。
extern "C" 的正确写法和位置
必须作用于函数声明（不是定义），且需在C++代码中包裹C头文件或函数声明。常见错误是只加在实现文件里，或漏掉条件宏。
- 推荐写法：在C++头文件或源文件顶部，用
#ifdef __cplusplus包裹 - 不要在C头文件里加
extern "C"—— 那会让C编译器报错 - 如果C库提供了自带的
extern "C"宏（如LIBRARY_API_BEGIN），优先用它的
#ifdef __cplusplus
extern "C" {
#endif
#include "c_library.h" // 确保这个头里全是C风格声明
#ifdef __cplusplus
}
#endif
混合使用C和C++类型时的陷阱
C++调用C函数时，参数和返回值必须是C兼容类型。C++特有类型（如 std::string、class、重载函数）不能直接传入C函数。
- 字符串：C函数期望
const char*，别传std::string对象，要用s.c_str() - 结构体：若C头里定义了
struct config { int a; };，C++中可直接用，但别在里面加构造函数或虚函数 -
回调函数：C库要求传函数指针时，回调函数必须是
extern "C"链接属性，否则C库调用会崩溃
extern "C" {
void my_callback(int code) {
// 这个函数可被C库安全调用
}
}
// 注册时：
c_library_set_callback(my_callback); // 正确
// c_library_set_callback([](int){}); // 错误：lambda不是C链接函数
静态库/动态库链接时的额外注意
即使声明加了 extern "C"，链接阶段仍可能失败，原因常不在C++侧。
立即学习“C语言免费学习笔记（深入）”；
- 确保链接顺序：C++目标文件在前，C库（
-lc）在后，例如g++ main.o -L. -lc_library - 检查C库是否为当前架构编译（x86_64 vs arm64）、是否含调试符号（
nm -C libxxx.a | grep init可查符号是否存在） - Windows下若C库是DLL，要确认导出方式：C头里应有
__declspec(dllimport)，且C++调用时需对应
最易忽略的是：C库内部调用了另一个C++运行时（比如它偷偷 new 了对象），而你的工程没链接 libstdc++ 或 libc++ —— 这会导致运行时崩溃，而非链接时报错。
