名称修饰（Name Mangling）是c++编译器对源代码中的函数、变量等符号进行重命名的机制，目的是让同名但参数不同的函数、不同作用域的同名符号在编译后生成唯一的标识符，从而支持函数重载、命名空间等c++特性，同时保证链接阶段符号解析的正确性。
名称修饰的核心作用
c语言不支持函数重载，因为c编译器编译后的函数名和源代码中的函数名基本一致，如果出现两个同名函数，链接时就会出现符号重复的错误。而c++支持函数重载，核心就是依靠名称修饰机制，编译器会根据函数的返回值、参数类型、参数个数、所属类或命名空间等信息，对原始函数名进行编码，生成唯一的修饰名，这样即使源代码中的函数名相同，只要参数等特征不同，编译后的修饰名就会不同，链接时就不会产生冲突。
c++编译器如何处理函数重载
当我们在代码中定义多个同名但参数不同的函数时，编译器会在编译阶段对每个函数进行名称修饰，生成不同的修饰名，具体处理流程如下：
- 首先解析函数的所有特征信息，包括函数名、所属命名空间、所属类、参数类型列表、const/volatile限定符、返回值类型等
- 按照编译器自身的修饰规则，将这些特征信息编码成字符串，和原始函数名组合生成修饰名
- 将修饰名作为该函数在目标文件中的符号名存储，后续链接阶段就使用这个修饰名进行符号匹配
函数重载的代码示例
我们先看一段包含函数重载的c++代码：
// 定义两个重载的函数
int add(int a, int b) {
return a + b;
}
double add(double a, double b) {
return a + b;
}
int main() {
int x = add(1, 2);
double y = add(1.5, 2.5);
return 0;
}
这两个add函数参数类型不同，属于合法的函数重载。如果使用g++编译这段代码，我们可以通过nm命令查看目标文件中的符号：
# 编译生成目标文件 g++ -c test.cpp -o test.o # 查看目标文件的符号表 nm test.o
在输出的符号表中，我们可以看到两个add函数的修饰名类似_Z3addii和_Z3adddd，其中_Z是g++修饰名的固定前缀，3表示原始函数名add的长度是3，ii表示两个int类型的参数，dd表示两个double类型的参数，这样两个函数的修饰名完全不同，链接时就不会冲突。
名称修饰如何支撑链接过程
链接阶段的核心工作之一是符号解析，也就是找到每个符号定义的位置。对于c++程序来说，链接器处理的都是修饰后的符号名：
- 当编译器编译一个源文件时，遇到函数调用，会先根据函数的参数等信息生成对应的修饰名，把这个修饰名作为未定义符号记录到目标文件中
- 当编译器编译函数定义的源文件时，会生成对应的修饰名作为已定义符号记录到目标文件中
- 链接器工作时，会将所有目标文件中的未定义符号和已定义符号进行匹配，只要修饰名完全一致，就认为找到了对应的函数定义
如果我们在代码中声明了函数但没有定义，或者函数重载的参数匹配错误，就会导致生成的修饰名没有对应的定义，链接器就会报未定义符号的错误。
不同编译器的名称修饰规则差异
需要注意的是，c++标准并没有规定名称修饰的具体规则，因此不同编译器厂商会实现自己的修饰规则：
- g++使用的修饰规则是Itanium C++ ABI的一部分，也是很多类Unix系统下编译器的通用规则
- MSVC（微软的c++编译器）有自己独立的修饰规则，生成的修饰名和g++的完全不同
这也导致不同编译器编译的目标文件无法直接链接，因为同一个函数在不同编译器下生成的修饰名不一样，链接器无法匹配。
MSVC下的修饰名示例
同样是最开始的add函数，使用MSVC编译后，通过dumpbin工具查看符号，int add(int, int)的修饰名可能是?add@@YAHHH@Z，double add(double, double)的修饰名可能是?add@@YANNN@Z，和g++的修饰名格式完全不同。
名称修饰的相关注意事项
在实际开发中，我们需要了解名称修饰的一些特性，避免出现问题：
- 如果需要在c++中调用c语言编写的函数，需要使用
extern "C"来告诉c++编译器，不要对后面的函数进行名称修饰，按照c语言的方式生成函数名，这样c++才能正确调用c函数 - 不要依赖名称修饰的规则来编写代码，因为不同编译器规则不同，代码可移植性会很差
- 如果遇到链接错误提示未定义符号，可以先查看报错中的修饰名，反推对应的函数特征，帮助定位问题
extern "C"的使用示例
// 按照c语言规则生成函数名，不进行名称修饰
extern "C" {
int c_add(int a, int b) {
return a + b;
}
}
// c++函数，会进行名称修饰
int cpp_add(int a, int b) {
return a + b;
}
上面的c_add函数编译后不会进行名称修饰，函数名就是c_add，而cpp_add会被修饰成类似_Z7cpp_addii的形式。
总结
名称修饰是c++支持函数重载、命名空间等特性的底层核心机制，编译器通过对函数的各类特征进行编码，生成唯一的修饰名，避免同名符号的冲突，同时支撑链接阶段的符号正确解析。不同编译器的修饰规则不同，这也是跨编译器链接不兼容的主要原因。了解名称修饰的原理，能帮助我们更好地理解c++的编译链接流程，快速定位开发中遇到的符号相关错误。
Name_Mangling函数重载链接编译器c++修改时间：2026-07-18 08:57:25