API是源码级接口规范，定义函数、类成员等供开发者调用；ABI是二进制兼容标准，规定调用约定、内存布局等机器层面细节。两者均影响模块交互，但ABI不兼容会导致链接失败或运行时错误，即使API一致。为提升ABI稳定性，应使用Pimpl模式、避免公开模板、遵循C ABI或指定调用约定。理解其区别有助于构建可靠C++库。
在C++开发中，ABI（Application Binary Interface，应用二进制接口）和API（Application Programming Interface，应用程序编程接口）是两个关键但容易混淆的概念。它们都涉及模块间的交互方式，但作用层级不同。
API：源码层面的约定
API定义的是源代码级别的接口规范。它告诉开发者如何使用某个库或组件，包括：
- 函数名、参数类型和返回值
- 类的公共成员函数和数据
- 头文件中的声明
- 命名空间结构
只要遵循相同的API，不同开发者编写的源码就可以正确调用彼此的功能。例如，你调用std::vector::push_back()，就是依赖STL提供的API。
ABI：二进制层面的兼容性
ABI关注的是编译后的目标文件之间能否直接链接和运行。它规定了：
立即学习“C++免费学习笔记（深入）”；
- 函数调用如何传递参数（调用约定，如cdecl、fastcall）
- 类对象的内存布局（虚表指针位置、成员偏移）
- 名称修饰（name mangling）规则
- 异常处理机制的实现方式
- RTTI（运行时类型信息）的格式
即使两个库API一致，如果ABI不兼容（比如用不同版本的编译器生成），链接时仍可能失败或运行出错。
两者关系与实际影响
API是给人看的接口，ABI是给机器用的契约。一个稳定的API不一定保证ABI兼容。例如：
- 添加类的私有成员可能改变对象大小，破坏ABI
- 修改模板实现不影响API，但需重新编译使用者代码
- 不同编译器（GCC vs MSVC）通常有各自的ABI规则
因此，发布动态库时不仅要保持API稳定，还需注意ABI兼容性，否则用户升级库版本后可能出现崩溃或链接错误。
如何提升ABI稳定性
为避免ABI问题，常见做法包括：
- 使用“Pimpl”模式隐藏类实现细节
- 避免在已发布接口中使用模板
- 明确指定调用约定（如__stdcall）
- 在Linux上遵循Itanium C++ ABI标准
- 跨平台组件使用C风格接口（C ABI最稳定）
基本上就这些。理解API与ABI的区别，有助于构建更可靠、可维护的C++库系统。
