必须用抽象基类导出接口而非具体类，因c++类直接导出会导致符号修饰不可控、abi不稳定、虚表布局依赖编译器版本；正确做法是仅导出纯虚接口类（如ishape），通过extern "c"工厂函数创建和销毁对象，并配合-fvisibility=hidden与显式visibility("default")控制符号可见性。
Clang下动态库导出C++类必须用抽象基类
直接导出具体类（比如 class Circle）在 Clang（以及 GCC）下几乎必然失败：符号修饰不可控、ABI 不稳定、虚表布局依赖编译器版本。正确做法是只导出纯虚接口类，所有实现细节彻底隐藏。
关键点在于：IShape 这类抽象基类本身不带实现，但它的虚函数表指针和析构逻辑是 ABI 可预测的；而具体派生类（Circle、Rectangle）完全留在动态库内部，不暴露任何符号。
-
IShape必须声明virtual ~IShape() = default;或virtual ~IShape() {}—— 缺少虚析构会导致调用方delete时未定义行为 - 所有成员函数必须是纯虚函数（
= 0），不能有默认实现 - 接口类里禁止出现非 static const 成员变量、模板成员、std::string 等可能触发 ABI 波动的类型
Clang编译时必须加 -fvisibility=hidden 并显式标记
Clang 默认导出所有全局符号，这会把你不希望暴露的实现类、辅助函数、静态变量全拖进动态库符号表，既增大体积又破坏封装。必须主动关闭默认导出。
正确编译命令示例（Linux/macOS）：
clang++ -std=c++17 -fPIC -fvisibility=hidden \ -shared shape_impl.cpp -o libshape.so
然后在头文件中用宏控制可见性：
#define SHAPE_API __attribute__((visibility("default")))
class SHAPE_API IShape { ... };
-
-fvisibility=hidden是开关，它让所有符号默认“隐藏” -
__attribute__((visibility("default")))只作用于你明确想导出的接口类和工厂函数 - 漏掉这个宏，
IShape在外部链接时会报undefined reference to 'typeinfo for IShape'
工厂函数必须用 extern "C" 包裹
C++ 名字修饰（name mangling）是编译器私有行为，不同版本 Clang 甚至同一版本不同参数都可能生成不同符号名。跨语言或跨编译器调用时，CreateCircle 这种函数名必须变成 C 风格的扁平符号。
头文件中这样写：
extern "C" {
SHAPE_API IShape* CreateCircle(double x, double y, double radius);
SHAPE_API void DestroyShape(IShape* shape);
}
-
extern "C"禁用名字修饰，确保符号名就是CreateCircle，不是_Z12CreateCircle... -
DestroyShape不可省略 —— 调用方没有IShape的完整定义，无法调用其析构函数，必须由库提供销毁入口 - 工厂函数返回裸指针是安全的，因为接口类无数据成员，且虚函数调用不依赖 this 指针偏移（只要 ABI 兼容）
Clang链接动态库时别忘了 -fPIC
Clang（和 GCC）在生成共享库时，要求所有目标文件都必须是位置无关代码。如果忘记 -fPIC，链接会失败并提示 relocation R_X86_64_32 against symbol 类错误。
常见错误组合：
- 只在
clang++ -shared命令里加-fPIC，但源文件编译成 .o 时没加 → 错 - 用
clang++ -c编译实现文件时漏掉-fPIC→ 错 - 静态库（.a）被链接进动态库时，其 .o 文件没用
-fPIC编译 → 链接时报错
稳妥做法：所有参与构建动态库的源码，无论是否直接暴露，一律用 clang++ -fPIC -c 编译。
真正麻烦的不是怎么写接口，而是怎么让调用方拿到对象后能安全析构、不崩溃、不内存泄漏——这取决于虚析构函数是否导出、DestroyShape 是否被正确调用、以及 IShape 的二进制布局是否在所有使用场景下保持一致。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
