C++头文件不能被C编译器直接包含，因其不识别class、std::string等C++语法；需用extern "C"封装为纯C接口，以不透明指针和C函数暴露功能，并用g++链接确保C++运行时支持。
为什么直接 #include C++ 头文件会报错
C 编译器不认识 class、public、std::string 这些 C++ 关键字和类型，遇到 C++ 头文件里带成员函数或模板的声明就直接罢工。典型错误是：error: unknown type name 'class' 或 error: expected ';' before '{' token。这不是头文件路径问题，是语言层不兼容。
必须把 C++ 类“藏”在 C 兼容的接口后面——也就是用纯 C 函数做一层包装，且所有暴露给 C 的函数签名里不能出现任何 C++ 类型。
怎么写一个 C 兼容的封装接口
核心是：用 extern "C" 禁止 C++ 名字修饰，并把对象生命周期和操作全部转成指针+函数调用。
- 在 C++ 源码（比如
myclass.cpp）里定义一个struct MyObject作为不透明句柄，实际就是void*的别名 - 所有对外函数都用
extern "C"声明，参数和返回值只用int、const char*、MyObject*这类 C 类型 - 构造函数对应
MyObject_create()，返回新分配的对象指针；析构对应MyObject_destroy(MyObject*) - 每个成员函数转成普通函数，第一个参数是
MyObject*，比如MyObject_do_something(MyObject*, int)
// myclass.h（供 C 代码包含）
#ifndef MYCLASS_H
#define MYCLASS_H
<h1>ifdef __cplusplus</h1><p>extern "C" {</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/3851895a4c84" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">C语言免费学习笔记（深入）</a>”；</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/gongju/2823" title="C++14"><img
src="https://img.php.cn/upload/manual/001/431/639/6ac8b33c327c4749.png" alt="C++14" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/gongju/2823" title="C++14">C++14</a>
<p>C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。</p>
</div>
<a href="/xiazai/gongju/2823" title="C++14" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><h1>endif</h1><p>struct MyObject;
typedef struct MyObject MyObject;</p><p>MyObject<em> MyObject_create(const char</em> name);
void MyObject_destroy(MyObject<em> obj);
int MyObject_get_value(MyObject</em> obj);
void MyObject_set_value(MyObject* obj, int v);</p><h1>ifdef __cplusplus</h1><p>}</p><h1>endif</h1><h1>endif</h1>编译时要注意链接和符号可见性
C++ 实现文件（myclass.cpp）必须用 C++ 编译器编译（如 g++ -c myclass.cpp -o myclass.o），而 C 调用方（main.c）用 gcc 编译，最后一起用 g++ 链接（不是 gcc），否则 C++ 标准库（如 std::string 构造）会链接失败。
- 链接命令必须用
g++ main.c myclass.o -o app，哪怕main.c是纯 C - 如果用
gcc链接，会报类似undefined reference to `operator new(unsigned long)' - Windows 下若用 MSVC，确保 C 文件也参与 C++ 链接流程，或显式链接
libcpmt.lib等运行时库
C 代码里怎么安全使用这个类
不要尝试解引用 MyObject*，它只是个句柄；也不要在 C 侧 free() 它——销毁必须走 MyObject_destroy()，因为内部可能用了 new 分配，或有虚表、异常清理逻辑。
- 检查
MyObject_create()返回是否为NULL，创建失败时 C++ 构造函数可能抛异常（需在封装函数里用try/catch转成NULL） - 字符串参数传入前确认是
UTF-8或 C 风格 null-terminated，避免 C++ 侧std::string构造越界 - 多线程环境下，如果 C++ 类本身不线程安全，封装函数也不自动加锁——得自己加
C++ 类的私有实现细节、异常机制、RTTI、虚函数表这些，C 层根本看不到，也没法绕过封装直接碰。真正麻烦的从来不是语法转换，而是谁负责内存、谁处理错误、谁管线程安全——这些边界一旦模糊，运行时崩溃比编译报错更难查。
