使用抽象接口和pimpl惯用法可保持C++库ABI兼容，避免STL类型暴露与内联函数，遵循类成员不变、虚函数有序添加等准则，确保二进制稳定。
在C++开发中，保持库的ABI（Application Binary Interface）兼容性是维护接口稳定性的关键。ABI兼容意味着不同编译时间或使用不同编译器版本构建的二进制模块可以正确链接和交互。一旦破坏ABI，使用者无需重新编译就可能导致崩溃、数据错乱或链接失败。
理解C++ ABI的影响因素
C++语言本身没有统一的ABI标准，实际行为依赖于编译器、平台和调用约定。影响ABI的主要因素包括：
- 类内存布局：成员变量顺序、虚函数表（vtable）结构、多重继承和虚继承的实现方式。
- 名称修饰（Name Mangling）：编译器对函数名的编码方式，不同编译器或版本可能不同。
- 调用约定：如__cdecl、__stdcall等，决定参数传递和栈清理方式。
- 异常处理机制：异常传播模型在不同编译器间可能不一致。
- 标准库实现：std::string、std::vector等类型的内部结构在不同版本中可能变化。
因此，确保ABI兼容需要从设计阶段就规避这些风险。
使用抽象接口隔离实现细节
最有效的策略是采用“接口与实现分离”模式，通常通过纯虚类（抽象基类）暴露服务。
立即学习“C++免费学习笔记（深入）”；
例如：
class ImageProcessor {
public:
virtual ~ImageProcessor() = default;
virtual int process(const char* data, size_t len) = 0;
virtual const char* getResult() const = 0;
};
// 工厂函数返回接口指针
extern "C" ImageProcessor* create_image_processor();
注意使用extern "C"包装工厂函数，避免C++名称修饰带来的链接问题。这样，使用者只依赖虚函数表调用，不感知具体类的大小或内存布局。
避免在公开头文件中暴露STL类型
直接在公有接口中使用std::string、std::vector
替代方案包括：
- 用const char*代替std::string传入字符串。
- 用指针+长度方式传递数组，如process_data(const uint8_t*, size_t)。
- 封装容器为私有实现，通过接口方法逐个访问。
若必须使用模板或STL，可考虑将其实现隐藏在动态库内部，仅导出非模板函数。
遵循二进制兼容修改准则
对已有类进行修改时，需遵守以下规则以维持ABI：
- 不要改变已有类的成员变量：增删或重排都会改变对象大小和偏移。
- 可在派生类中添加虚函数，但不能在已有继承层次中间插入新虚函数。
- 避免内联函数暴露在头文件：内联函数修改后使用者必须重新编译。
- 使用“pimpl”惯用法（Pointer to Implementation）隐藏私有成员：
class Logger {
public:
Logger();
~Logger();
void log(const std::string& msg);
private:
class Impl;
Impl* pImpl; // 只定义指针，Impl结构对外不可见
};
这样Impl的变更不会影响Logger的ABI。
基本上就这些。只要控制好接口粒度、隐藏实现细节、谨慎修改已有结构，就能长期维持C++库的二进制兼容性。关键是把“谁会链接我”时刻放在心上。
