C++实现纯C接口需同时满足符号导出按C规则和ABI边界不越界：定义必须加extern "C"，头文件需用__cplusplus保护且禁用C++语法，C++对象通过不透明指针封装，异常须捕获转错误码。
直接说结论：C++ 实现纯 C 接口，核心不是加个 extern "C" 就完事，而是必须做两件事——符号导出按 C 规则、ABI 边界不越界。否则编译能过，链接失败或运行崩溃是常态。
为什么 extern "C" 声明后还是 undefined reference
常见现象是 C++ 源文件里写了 extern "C" void foo();，C 文件里调用 foo()，链接时报 undefined reference to 'foo'。根本原因往往不是声明漏了，而是定义没对齐：
- 声明用了
extern "C"，但定义在另一个 .cpp 文件里没加——C++ 编译器对定义仍做 name mangling - 头文件被 C++ 源文件包含时生效，但被 C 源文件包含时，如果头文件里混了 C++ 特有语法（比如
std::string参数），C 编译器直接报错退出，导致后续声明根本没被处理 - 函数定义写在类内部（隐式 inline），即使加了
extern "C"，inline 函数的链接属性也不受控制，符号可能未生成或变成 local
验证方法：用 nm -C your_obj.o | grep foo 看符号是否以裸名 foo 出现；若看到 _Z3foo 或类似，说明定义侧没生效。
C++ 类功能如何暴露给 C 调用
extern "C" 不能用于成员函数，也不能让 C 直接操作 class。正确做法是分层封装：
立即学习“C++免费学习笔记（深入）”；
- 在 C++ 实现中定义自由函数（非成员），用
extern "C"导出，只收发 C 兼容类型（int、void*、const char*等） - 用不透明指针（
typedef struct FooHandle *FooHandle;）隐藏 C++ 对象实例，所有操作通过 handle 传入 - 构造/析构也必须是 C 风格函数，例如
FooHandle foo_create(); void foo_destroy(FooHandle h); - 所有 C++ 异常必须在 C 接口函数内捕获并转为错误码返回，绝不能让
throw穿过extern "C"边界
示例接口头文件片段：
#ifdef __cplusplus
extern "C" {
#endif
<p>typedef struct CalculatorHandle *CalculatorHandle;</p><p>CalculatorHandle calculator_create();
void calculator_destroy(CalculatorHandle h);
int calculator_add(CalculatorHandle h, int a, int b);</p><h1>ifdef __cplusplus</h1><p>}</p><h1>endif</h1><p>头文件怎么写才真正兼容 C 和 C++
关键不在语法炫技，而在预处理器保护和类型洁癖：
- 必须用
#ifdef __cplusplus包裹extern "C"块，且严格配对，漏掉#endif会导致整个后续头文件被误判为 C 链接 - 头文件里禁止出现任何 C++ 关键字：
class、template、std::、引用（&）、重载函数声明 - 不要在头文件里
#include <string>或#include <vector>；如需字符串操作，用const char*+ 长度参数替代 - 如果头文件要被 C 使用，就绝对不要用
static inline函数——C 编译器可能不支持，且 inline 不影响链接属性
一个典型错误是：在 extern "C" 块里声明 void log_msg(std::string msg);，C 编译器连第一行都过不去。
构建时 gcc 和 g++ 混用的坑
很多项目用 g++ main.c foo.cpp -o app 一键编译，这看似省事，实则埋雷：
-
main.c被g++当作 C++ 源文件处理，会启用 C++ 语义（比如把void* p = malloc(10);当作错误），掩盖真实 C 兼容性问题 - 正确方式是分开编译：
gcc -c main.c -o main.o（确保 C 语义） +g++ -c foo.cpp -o foo.o（C++ 语义），再统一链接：g++ main.o foo.o -o app - 链接阶段必须用
g++（而非gcc），因为 C++ 运行时库（如libstdc++）需要被自动链接，否则可能报undefined reference to '__cxa_begin_catch'等 ABI 符号缺失
最易被忽略的一点：C 接口函数若内部调用了 C++ 标准库（比如 std::vector::push_back），该函数虽导出为 C 符号，但链接时仍依赖 C++ 运行时——这点在嵌入式或纯 C 环境中极易翻车。
