Name Mangling是C++编译器将函数名、参数类型等信息编码为唯一符号的技术，以支持函数重载和复杂命名结构；例如_Z5printi表示void print(int)，不同编译器如GCC与MSVC采用不同mangling规则，导致跨编译器链接不兼容，而extern "C"可关闭mangling实现C语言链接兼容。
C++支持函数重载，也就是说你可以有多个同名但参数不同的函数。然而，编译器最终生成的机器代码并不能直接使用“重载”这一高级语言特性，因为底层链接器通常只认简单的符号名称。为了解决这个问题，C++编译器采用了一种叫
Name Mangling
（名字修饰或名称改编）的技术，将函数的名称、参数类型、返回值、所在命名空间等信息
编码
成一个唯一的底层符号名。
什么是Name Mangling？
在C++中，两个函数可以同名但参数不同：
void print(int x);void print(double x);void print(const std::string& s);
这些函数在源码中都叫
print
，但在编译后的目标文件中，它们必须有不同的符号名，否则链接器无法区分。Name Mangling 就是编译器用来把 C++ 的复杂声明转换成唯一、可链接的低层符号的过程。
例如，GCC 编译器可能会把
转换成类似
_Z5printi
的符号：
立即学习
“
C++免费学习笔记（深入）
”；
_Z
：表示这是一个 mangled name
5print
：函数名长度为5，名字是 print
i
：参数类型 int 的编码
为什么需要Name Mangling？
汇编和链接器原本是为C语言设计的，而C语言不支持函数重载，每个函数名必须唯一。C++引入了重载、命名空间、类成员函数、模板等特性，使得仅靠函数名无法唯一标识一个函数。
通过 Name Mangling，编译器可以：
支持函数重载：不同参数的同名函数生成不同的符号
记录函数所属的类或命名空间
包含模板实例的信息
确保链接时能正确匹配调用和定义
不同编译器的Mangling规则不同
需要注意的是，Name Mangling 没有统一的国际标准，各编译器厂商有自己的编码规则：
GCC 和 Clang 使用的是基于 Itanium C++ ABI 的 mangling 规则（即使在 Windows 上）
MSVC（Visual Studio）使用自己的一套私有 mangling 方式
这意味着用 GCC 编译的库，其符号名与 MSVC 生成的不同，即使函数原型一样，也无法直接链接——这是 C++ 库跨编译器兼容性差的主要原因之一。
Trae win
Trae Windows 官方版本现已全面支持 Win10 和 Win11 系统（64位）。国内开发者可直接访问 Trae 中文官网（trae.cn 或 trae.com.cn），一键下载官方正版 .exe 安装包，享受国内直连的高速稳定体验。安装过程极其简便，双击即可运行，并支持一键无缝导入 VS Code 或 Cursor 的原有主题、快捷键及插件配置。登录支持手机号、微信或稀土掘金账号。内置免费的豆包与 DeepSeek 等顶级大模型，让你开箱即用，轻松开启高效的 AI 智能编程之旅。
下载
如何查看和解析 Mangled 名称？
Linux 下可以用
c++filt
工具反解 mangled 名字：
$ nm a.out | grep print000000000000112a T _Z5printi0000000000001134 T _Z5printd
然后使用：
$ c++filt _Z5printiprint(int)
也可以直接用：
$ objdump -C -t a.out | grep print
其中
-C
表示 demangle（去修饰）符号名。
extern "C" 与关闭 Name Mangling
当你使用
extern "C"
声明函数时，就是在告诉编译器：
不要对这个函数进行 name mangling
，使用 C 语言的链接方式。
这常用于：
让 C++ 函数能被 C 代码调用
实现
回调函数
接口
编写动态库时提供兼容的 API
extern "C" {void legacy_init(); // 符号名就是 legacy_init，不会被修饰}
基本上就这些。Name Mangling 是 C++ 实现多态性和重载的关键底层机制之一，虽然开发者平时看不到它，但它每天都在默默工作，确保你的重载函数不会“撞名”。理解它有助于调试链接错误、分析符号冲突，以及跨语言混合编程。
void print(int)