C++支持函数重载特性，允许在同一个作用域内定义多个同名函数，只要它们的参数列表不同即可。但目标文件中的符号是全局唯一的，编译器需要一种方式区分这些同名但参数不同的函数，这就是Name Mangling（名字修饰）机制的作用。
什么是Name Mangling
Name Mangling是C++编译器在编译阶段对函数名、变量名等标识符进行重写的过程，会结合函数的返回类型、参数类型、所属类或命名空间等信息，生成一个唯一的字符串作为该函数在目标文件中的符号名。这个过程的目的是让同名但特征不同的函数拥有不同的符号标识，从而支持函数重载、命名空间、模板等C++特性。
需要注意的是，C语言没有函数重载，因此C编译器的Name Mangling规则非常简单，通常只是在函数名前加一个下划线，比如函数add会被修饰为_add。而C++的修饰规则复杂得多，因为要承载更多函数特征信息。
Name Mangling如何处理函数重载
函数重载的核心区分依据是参数列表的差异，Name Mangling会将参数类型、数量、顺序等信息编码到符号名中，具体流程如下：
1. 提取函数特征信息
编译器首先会收集函数的完整特征，包括：
- 函数所属的作用域（全局、命名空间、类）
- 函数名本身
- 参数列表的类型、数量、顺序
- 函数的const/volatile限定符（如果是成员函数）
2. 编码生成符号名
不同编译器的编码规则不同，以GCC编译器为例，它会使用_Z开头，后面跟着函数名长度、函数名，再跟上参数类型的编码。比如下面的两个重载函数：
// 两个重载的add函数
int add(int a, int b) {
return a + b;
}
double add(double a, double b) {
return a + b;
}
经过GCC的Name Mangling后，第一个函数的符号名会被修饰为_Z3addii，其中_Z是GCC的标识，3是函数名add的长度，add是函数名，ii表示两个int类型参数。第二个函数的符号名会被修饰为_Z3adddd，末尾的dd表示两个double类型参数，这样两个同名函数就有了不同的符号名，不会在链接时冲突。
3. 链接阶段的符号匹配
编译生成目标文件后，链接阶段会根据调用处的函数参数类型，匹配对应的修饰后符号名，找到正确的函数实现。如果调用时参数类型和任何重载函数的参数都不匹配，编译器会报找不到匹配函数的错误。
不同编译器的Name Mangling差异
Name Mangling并没有统一的标准，不同编译器厂商的实现规则不同：
- GCC系列编译器使用以
_Z开头的编码规则，对参数类型、作用域都有明确的编码映射。 - MSVC编译器使用以
?开头的编码规则，编码格式和GCC完全不同，因此GCC编译的目标文件和MSVC编译的目标文件无法直接链接。 - Clang编译器在大部分情况下和GCC的Name Mangling规则兼容，以保证生成的符号可以互相链接。
查看Name Mangling结果的方法
我们可以通过工具查看目标文件中的符号，来验证Name Mangling的效果。以Linux下的GCC为例，使用nm命令可以查看目标文件的符号表：
# 编译生成目标文件 g++ -c test.cpp -o test.o # 查看符号表 nm test.o | grep add
执行后会看到类似如下的输出，其中就包含修饰后的符号名：
0000000000000000 T _Z3addii 0000000000000010 T _Z3adddd
Name Mangling的其他应用场景
除了支持函数重载，Name Mangling还支撑着C++的其他特性：
- 命名空间区分：不同命名空间下的同名函数会被编码为不同的符号，比如
namespace A { void func() {} }和namespace B { void func() {} }的func函数符号完全不同。 - 类成员函数区分：类的成员函数会编码所属类名，不同类的同名成员函数不会冲突。
- 模板函数实例化：模板函数会根据不同的模板参数类型生成不同的实例化版本，每个版本都有独立的修饰符号。
注意事项
由于Name Mangling的规则不统一，如果需要在C++中调用C语言编写的函数，需要使用extern "C"来禁止Name Mangling，让编译器按照C的规则修饰函数名，避免链接错误：
// 禁止对add函数进行C++的Name Mangling，按照C规则修饰
extern "C" {
int add(int a, int b);
}
这样add函数的符号名就会被修饰为_add，和C编译器生成的符号一致，就可以正常链接了。
Name_Mangling函数重载编译器C++符号修饰修改时间：2026-06-22 23:15:47