C编译器不支持C++语法（如class、命名空间、重载等），且ABI不兼容，需用extern "C"封装纯C接口并管理对象生命周期，否则编译或链接失败。
为什么直接在C里#include C++头文件会报错
C编译器不认识C++的语法糖，比如类、成员函数、重载、命名空间这些。你一写 class MyClass { public: void func(); };，C编译器当场罢工，报一堆 syntax error before '{' 或 unknown type name 'class'。这不是链接问题，是编译阶段就过不去。
- C和C++的ABI（应用二进制接口）默认不兼容：C++函数名会被mangle（修饰），比如
MyClass::func()可能变成_Z3funcv，而C只认func这种平直符号名 - C没有
this指针概念，没法直接调用非静态成员函数 - 即使把C++代码全改成
static函数，头文件里只要出现class、public:、std::string等，C编译器就拒绝处理
怎么写一个C可调用的C++函数接口
核心动作就一个：用 extern "C" 把C++函数“扁平化”，再用纯C风格封装对象生命周期。
- 在C++源码中，把要暴露给C的函数用
extern "C"包裹（必须在C++文件里写，不能只在头文件里声明） - 所有参数和返回值只能是C兼容类型：基本类型（
int、void<em></em>）、C结构体（不能含成员函数或虚表）、const char；禁止std::vector、std::string、引用、重载 - 类实例的创建/销毁必须导出为独立函数，比如
MyClass<em> create_myclass()</em>和void destroy_myclass(MyClass obj) - 成员函数调用转为普通函数，第一个参数传
MyClass<em></em>模拟this，例如：extern "C" { MyClass</em> create_myclass() { return new MyClass(); } void destroy_myclass(MyClass<em> obj) { delete obj; } int myclass_do_work(MyClass</em> obj, int x) { return obj ? obj->do_work(x) : -1; } }
C端怎么安全使用这个接口
C代码完全当它是个普通C库用，但要注意内存归属和空指针。
- 头文件必须用
#ifdef __cplusplus保护extern "C"块，否则C++代码包含自己头文件时会出错 - C端绝不直接访问C++对象内存布局（比如用
offsetof算成员偏移），那是未定义行为 - 所有返回的
void*或对象指针，必须配对调用销毁函数，否则泄漏（C没析构概念） - 如果C++构造函数可能抛异常，
create_*函数里必须用try/catch吞掉，并返回NULL，否则异常穿透到C会导致未定义终止
链接时常见的undefined reference错误怎么查
这类错误90%不是写错了函数名，而是混合编译环节出了岔子。
立即学习“C++免费学习笔记（深入）”；
- 确保C++实现文件（如
myclass_wrapper.cpp）被编译成目标文件，且参与最终链接；如果只编译了C文件，create_myclass当然找不到 - 检查是否误把
extern "C"写在头文件的声明里，但没在C++实现文件里真正定义——C++编译器不会帮你生成C链接符号 - 用
nm -C libxxx.a | grep create_myclass看符号是否存在且未mangle（应该显示为create_myclass，而不是_Z13create_myclassv） - GCC下混链必须用
g++做最后链接（哪怕主程序是C），因为C++标准库依赖需要libstdc++，用gcc链接会缺符号
C++类本身没法“直接”被C调用，所有绕不过去的步骤都得手动桥接：名字解修饰、对象生命周期管理、this指针模拟、异常隔离。漏掉任何一环，轻则链接失败，重则运行时崩在虚表或析构上。
