名字修饰（Name Mangling）是C++编译器在编译阶段，把函数、变量、类成员、模板实例等源码中的标识符，转换成一串唯一、可链接的底层符号名的过程。它不是语法糖，而是支撑C++多态能力的底层基础设施——没有它，函数重载、命名空间、类作用域、模板特化这些特性根本无法在二进制层面正确工作。
为什么必须做名字修饰？
C语言链接器只认“一个名字对应一个地址”，不理解参数类型、作用域或返回值。而C++允许：
- 同名函数有不同参数（void foo(int) 和 void foo(double)）
- 同名函数在不同类里（A::bar() 和 B::bar()）
- 同名函数在嵌套命名空间中（ns1::ns2::func()）
- 模板生成多个具体版本（vector
::push_back() 和 vector::push_back() ）
这些在源码中靠语义区分，但目标文件（.o/.obj）里只能存扁平的符号表。编译器必须把所有上下文信息“编码进名字里”，让链接器能无歧义地匹配调用与定义。
名字是怎么被“编码”的？以Itanium ABI（GCC/Clang主流规则）为例
修饰名不是随机字符串，而是有结构的编码序列。比如：
立即学习“C++免费学习笔记（深入）”；
- _Z4funci → 普通函数 func(int)（_Z 表示mangled，4=func长度，func，i=int）
- _ZN5MyClass4funcEi → MyClass::func(int)（N...E 包裹作用域，5MyClass=命名空间/类名，4func=函数名，i=参数）
- _Z3fooid → foo(int, double)（ii 表示两个int，id 表示 int+double）
类型编码有固定映射：i=int，d=double，Pi=int*，St=std::，PKc=const char* 等。整个规则由ABI（Application Binary Interface）定义，跨编译器不兼容——GCC生成的 _Z 开头符号，MSVC根本看不懂。
什么时候会绕过名字修饰？extern "C" 的作用
当你写 extern "C"，就等于告诉编译器：“别修饰，按C语言规则处理——函数名原样导出”。典型场景：
- C++代码调用C标准库（如 printf），C库符号没被修饰，C++必须也禁用修饰才能链接上
- C++写DLL或so时，想提供纯C接口给其他语言（Python/Rust/Go）调用，避免对方解析复杂修饰名
- 链接时出现 undefined reference to 'xxx'，但你确认函数已定义——很可能一方用了 extern "C"，另一方没用，导致符号名对不上
怎么观察和调试修饰名？
实际开发中极少手写修饰名，但排查链接问题时必须会看：
- nm -C your_file.o：直接显示“可读名”（-C 自动 demangle）
- nm your_file.o | grep func：看原始修饰名（如 _Z4funci）
- c++filt _Z4funci：把修饰名转回源码形式（输出 func(int)）
- objdump -t your_file.o：查看完整符号表，含地址、绑定、大小等
注意：同一份C++代码，用GCC和MSVC编译，生成的修饰名完全不同，所以预编译库（.a/.lib）不能跨编译器混用——ABI不兼容的本质，就藏在这串修饰名的格式差异里。
