API 是源码接口规范，定义函数、类等可调用元素；ABI 是二进制调用规则，涉及符号命名、参数传递、内存布局等。API 变化影响编译，ABI 不兼容导致链接或运行失败。C++ 中不同编译器或版本易引发 ABI 问题，故需避免暴露 STL、使用 C 封装提升兼容性。保持 API 稳定降低迁移成本，保持 ABI 稳定支持无缝升级。
在 C ++ 库开发中，ABI（Application Binary Interface）和 API（Application Programming Interface）是两个核心但容易混淆的概念。它们都涉及库的接口设计，但作用层级和影响范围不同。
API：源码层面的接口契约
API 指的是应用程序与库之间在源代码层面的交互方式。它定义了开发者能调用哪些函数、类、方法、参数类型、返回值、命名空间等。只要代码能通过编译，就说明符合 API 规范。
例如，一个简单的 API 可能长这样：
namespace mathlib {int add(int a, int b); class Calculator {public: double multiply(double x, double y); }; }只要用户按照这个声明来写代码，比如调用 mathlib::add(2, 3) 或创建 Calculator 对象，就属于正确使用 API。
立即学习“C++ 免费学习笔记（深入）”；
API 的变化通常会影响源码兼容性。比如把函数名从 add 改成 sum，旧代码就会编译失败。
ABI：二进制层面的调用规则
ABI 关注的是编译后的目标文件或库如何在二进制层面被调用。它包括函数符号的命名方式（name mangling）、参数传递顺序、堆 栈管理、对象内存布局（如虚表位置）、异常处理机制等。
即使两个程序使用相同的 API，如果它们的 ABI 不兼容，链接或运行时仍会出错。
C++ 的 ABI 问题比 C 更复杂，因为 C ++ 有函数重载、类、模板、异常等特性，这些都会影响符号生成和对象布局。
常见 ABI 规则包括：
- 函数名如何进行 name mangling（如 _Z3addii 表示 int add(int, int)）
- 类成员函数的 this 指针传递方式
- 虚函数表（vtable）的结构和布局
- 结构体或类的对齐和填充 字节
- 调用约定（calling convention），如 cdecl、fastcall 等
例如，如果库是用 GCC 5 编译的，而你的程序用 GCC 10 编译，默认情况下可能仍然兼容，但如果启用了不同的 C ++ 标准（如 C++11 的 std::string ABI 变化），就可能出现符号找不到或崩溃。
为什么ABI 对 C ++ 库开发特别重要？
在 C 语言中，ABI 相对稳定，很多系统间的共享库可以通用。但在 C ++ 中，不同编译器（GCC、Clang、MSVC）、甚至同一编译器的不同版本或编译选项，都可能导致 ABI 不兼容。
这意味着：
- 你发布的库必须明确说明支持的编译器和版本
- 避免在公开接口中暴露 STL 容器（如 std::vector、std::string），除非确保使用者使用相同 ABI
- 尽量使用 POD 类型、C 风格接口或抽象接口类（abstract base class）来增强 ABI 稳定性
一个常见的做法是提供“C”封装层：
extern "C" {void* create_calculator(); double calculator_multiply(void* calc, double x, double y); void destroy_calculator(void* calc); }这样能绕过 C ++ 的 name mangling 和对象布局问题，提升跨编译器兼容性。
总结：API 是能怎么用，ABI 是能不能连上
简单来说，API 决定你能否写出正确的调用代码，ABI 决定编译后的程序能否正确链接并运行。
开发 C ++ 库时，保持 API 稳定有助于减少用户迁移成本，而保持 ABI 稳定则能让用户无需重新编译就能升级库版本。
基本上就这些，理解清楚这两个概念，才能做出真正可用、可维护的 C ++ 库。
