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++库。
