1 / 4概念
Runtime: Object Model and ABI
C++ 标准规定语义,不规定字节。一个类在内存里的偏移、一个成员函数在符号表里的名字、一次跨模块调用由谁清栈,全部由编译器与平台共同约定的 ABI 决定。判断标准只有一条:能否同时给出对象布局的偏移、修饰后的符号名,以及跨边界调用的约定。
1 概念
1.1 一句话定义
ABI 是已编译代码之间的二进制契约,覆盖名字修饰、对象与 vtable 布局、RTTI 表示、调用约定、异常展开、静态初始化六件事;Itanium C++ ABI 由 GCC 与 Clang 在 Linux、macOS、BSD 上使用,MSVC ABI 由 MSVC 与 clang-cl 在 Windows 上使用,两者互不兼容。
1.2 它解决什么问题
- 分离编译:不同翻译单元只交换符号与布局,编译器无法在链接期重新协商类型。
- 动态链接与插件:宿主与插件各自编译,ABI 不一致时链接能通过、运行才崩溃。
- 跨语言边界:C 与 C++ 共享同一套调用约定与布局时,
extern "C"提供稳定入口。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 类、继承形态与切片 | OOP(cpp-classes-and-abstraction) |
| C 的对象模型与 ABI | Runtime: ABI and Object Model(c-object-model-and-abi) |
| 跨语言调用与 FFI | Interop: C ABI and Foreign Calls(c-ffi) |
异常展开与 noexcept | Runtime: Exception Unwinding(cpp-exception-runtime) |
| 分配函数与对齐 | Runtime: Memory Layout and Allocation(cpp-memory-allocation) |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| name mangling | 把 C++ 名字编码成链接器符号 | 只编码名字,不编码布局 |
| vtable | 每个多态类一份的只读函数指针表 | 标准不规定其存在形式 |
| vptr | 对象内指向 vtable 的指针 | 不是对象字段,不能取地址 |
| RTTI | type_info 及其继承结构 | typeid 与 dynamic_cast 的数据源 |
| thunk | 调整 this 后跳转的小段代码 | 不是用户函数 |
| VTT | 虚继承构造期使用的 vtable 表 | 运行期虚调用不走 VTT |
| abi_tag | 附着在符号上的 ABI 版本标记 | 不改变源码类型 |
2 机制
2.1 心智模型
源文件先变成“符号 + 字节 + 重定位”:符号由名字修饰决定,字节由对象布局决定,重定位由调用约定与静态初始化决定。链接器只匹配名字,不理解类型;因此 ABI 错配的典型表现是链接失败或运行期读到错位的字段,而不是编译错误。
2.2 机制拆解
- 名字修饰:Itanium 以
_Z开头,嵌套名用N...E包裹,标识符带长度前缀,成员函数的 cv 与引用限定符编码为K、V、R、O;普通函数的返回类型不参与修饰,因此不能仅靠返回类型重载。MSVC 以?开头,用@分隔作用域,访问级别与调用约定进入编码。 - vtable 与 vptr:Itanium 的地址点指向第一个虚函数槽,负槽
vptr[-1]是type_info,vptr[-2]是 offset-to-top;MSVC 的vfptr[-1]是 Complete Object Locator,vfptr[0]起才是虚函数槽。构造与析构期间 vptr 被逐层改写,所以此时虚调用只到当前层。 - RTTI 描述符:Itanium 的
__class_type_info、__si_class_type_info、__vmi_class_type_info分别描述单继承、单基链与多继承;dynamic_cast沿这些描述符做运行期检查,typeid比较type_info对象。 - 多继承:第一个动态基类通常作为主基类共享 vptr,后续基类各带 vptr;派生指针转成第二基类指针时加上偏移,secondary vtable 的槽里放 non-virtual thunk,先把
this调回完整对象再跳转。 - RTTI 与 thunk 的分工:RTTI 只回答“是什么类型”,指针调整由 thunk 完成;两者都存在时,
dynamic_cast走类型图,虚调用走 vtable 槽。 - 虚继承:虚基类子对象放在对象末尾,位置由 vtable 中的虚基偏移给出;构造期用 VTT 与 construction vtable 定位共享基类,因此访问虚基成员多一次间接,布局也更难预测。
- ABI 稳定性:稳定要求同一编译器、同一标准库、同一组 ABI 开关。libstdc++ 的 dual ABI 把
std::string放在std::__cxx11内联命名空间,_GLIBCXX_USE_CXX11_ABI不同就产生不同符号;libc++ 与 libstdc++ 的容器布局不同;_GLIBCXX_DEBUG会改变容器大小。 - C 边界:
extern "C"关闭名字修饰与重载,但不改变调用约定,也不保证布局;跨边界只应传标准布局类型或不透明指针,异常必须在边界内被捕获,所有权与释放方要写进契约。
2.3 完整枚举
Itanium C++ ABI 为多态与初始化生成的合成符号就是下面这一组,符号名可用 nm 观察、用 c++filt 还原。
| 符号 | 含义 | 生成条件 | 观察 |
|---|---|---|---|
_ZTV<class> | vtable,含负槽与虚函数槽 | 类有虚函数 | nm -C 显示 vtable for |
_ZTT<class> | VTT,构造期 vtable 的索引表 | 类有虚基类 | nm -C 显示 VTT for |
_ZTC<class><offset>_<base> | construction vtable,按基类在对象中的偏移命名 | 虚基类在构造期需要 | c++filt 显示 base-in-class |
_ZTI<class> | type_info 对象 | 类可被 typeid 或 catch 使用 | nm -C 显示 typeinfo for |
_ZTS<class> | type_info 的名称字符串 | 与 _ZTI 同时生成 | nm -C 显示 typeinfo name for |
_ZGV<...> | 函数内静态变量的 guard 变量 | 局部静态需要线程安全初始化 | nm 显示 guard variable |
_ZTH<...> | 线程局部变量的初始化函数 | thread_local 带动态初始化 | nm 显示 thread-local init |
2.4 两套 ABI 对照
| 面 | Itanium(GCC/Clang) | MSVC(MSVC/clang-cl) |
|---|---|---|
| 名字修饰 | _Z 前缀,长度前缀标识符 | ? 前缀,@ 分隔作用域 |
| vtable 头 | vptr[-1] 为 type_info,vptr[-2] 为 offset-to-top | vfptr[-1] 为 Complete Object Locator |
| 多继承调整 | non-virtual thunk 调整 this | adjustor thunk 调整 this |
| 虚继承 | VTT 与 construction vtable,虚基偏移在 vtable 中 | vbptr 指向 virtual base table |
| RTTI 符号 | _ZTI、_ZTS,描述符为 __class_type_info 系列 | ??_R0 到 ??_R4 五类描述符 |
| 异常模型 | 表驱动 DWARF 展开与 personality routine | x64 上基于 SEH 与 __CxxFrameHandler3 |
| 调用约定 | 平台 C 约定,this 作为首个参数 | x86 用 __thiscall,x64 统一为寄存器传参 |
3 实践
3.1 最小示例
#include <cstdio>
struct Base {
virtual ~Base() = default;
virtual const char* name() const { return "Base"; }
int tag = 1;
};
struct Left : Base {
const char* name() const override { return "Left"; }
int l = 2;
};
struct Right {
virtual ~Right() = default;
virtual const char* side() const { return "Right"; }
int r = 3;
};
struct Both : Left, Right {
const char* name() const override { return "Both"; }
const char* side() const override { return "Both"; }
};
int main() {
Both b;
Base* base = &b;
Right* right = &b;
std::printf("sizeof(Base)=%zu sizeof(Both)=%zu\n", sizeof(Base), sizeof(Both));
std::printf("delta=%td %s %s\n", (char*)right - (char*)&b, base->name(), right->side());
}
编译并观察布局与符号:
clang++ -std=c++20 -Xclang -fdump-record-layouts -c abi.cpp -o abi.o
nm -C abi.o | grep -E 'Both|thunk'
nm abi.o | grep -E 'ZTV|ZTI|ZTS'
objdump -d --demangle abi.o | grep -A6 'non-virtual thunk to Both::side'
0 | struct Both
0 | struct Left (primary base)
0 | struct Base (primary base)
8 | int tag
12 | int l
16 | struct Right (base)
24 | int r
[sizeof=32, dsize=28, align=8]
Both::name() const
non-virtual thunk to Both::side() const
_ZTV4Both
_ZTI4Both
_ZTS4Both
subs x0, x0, #0x10
b Both::side() const
追踪:Both 的前 16 字节是 Left,其中 Base 在偏移 0,tag 在 8,l 在 12;Right 子对象从 16 开始,r 在 24,总大小 32。Base* 与 Both* 同址,Right* 要加 16,所以两个指针直接比较不相等。side 在 Right 的 secondary vtable 中,槽里是 thunk,反汇编显示它先把 this 减 16 再跳到 Both::side。符号表里 _ZTV4Both 是 vtable、_ZTI4Both 是 typeinfo;Mach-O 的 nm 会在前面多打印一个下划线,c++filt 仍能识别。
3.2 选型矩阵
| 边界需求 | 方案 | 保证 | 代价 |
|---|---|---|---|
| 跨编译器、跨语言调用 | extern "C" 加不透明指针 | 只有 C ABI 稳定 | 失去重载、模板与异常 |
| 同编译器插件接口 | C++ 抽象基类加虚析构 | 完整 C++ ABI | 编译器、标准库与选项锁定 |
| 长期稳定 SDK | 纯 C API 加版本号加 pimpl | 二进制兼容 | 一层间接与句柄管理 |
| 内部模块 | 同一构建内静态链接 | 无版本问题 | 改动需要整体重编 |
| 跨标准库边界 | 只传自有类型与 POD | 不受 STL ABI 影响 | 重复实现字符串与容器 |
3.3 决策规则
- 先确定边界性质:跨编译器就退到 C ABI,同构建内才用 C++ ABI。
- 头文件里出现的类型就是 ABI 的一部分;不要把 STL 容器按值放进公开接口。
- 需要稳定时用 pimpl 把布局移出头文件,并禁止在边界上内联虚函数;C 边界用
static_assert与两侧sizeof校验。 - 升级编译器或标准库后重跑链接与符号检查,不靠“能编译”判断兼容。
4 边界
4.1 典型故障
| 症状 | 根因 | 诊断 | 修复 |
|---|---|---|---|
定义存在却报 undefined reference to foo(int) | C 与 C++ 名字修饰不一致 | nm -C 看两边的符号名 | 声明处加 extern "C",或统一语言 |
| 同一头文件在 Windows 与 Linux 都编译通过,运行即崩 | vtable 与 RTTI 布局不同 | 看崩溃栈与二进制来源 | 在边界退到 C ABI,分别编译 |
升级 GCC 后旧库报 std::__cxx11::basic_string 未定义 | libstdc++ dual ABI 开关不同 | nm -D 查符号是否带 __cxx11 | 统一 _GLIBCXX_USE_CXX11_ABI |
| 多继承下两个基类指针比较不相等 | 指针已调整到不同子对象 | 打印地址与 delta | 用 dynamic_cast<void*> 取完整对象地址 |
dynamic_cast 返回空但类型确实匹配 | 跨 DSO 的 type_info 未合并 | typeid 名称与地址 | 统一符号可见性,或改传 tag |
sizeof 与 C 侧不一致 | 类型非标准布局,含虚函数或引用成员 | 两侧打印 sizeof 与 alignof | 改用标准布局类型并加 static_assert |
4.2 安全 / 性能 / 一致性边界
- 安全:ABI 错配通常不报错,先用
sizeof、alignof、符号名三项验证,再谈功能。 - 性能与一致性:虚调用阻止内联,多继承每次跨子对象调用多一条 thunk;
extern "C"只解决名字,不解决布局与异常,布局兼容必须由标准布局与固定宽度类型保证。