extern "C" 的本质是禁用 C++ 名字修饰以实现 C 链接兼容，而非仅为跨文件；它只影响符号名，不改变函数执行逻辑，需配合条件编译保护头文件供 C/C++ 共用。
直接说结论：C++ 里用 extern "C" 不是为了“跨文件”本身，而是为了防止 C++ 编译器对函数名做名字修饰（name mangling），让 C 链接器能认出它——跨文件只是常见使用场景，不是本质目的。
为什么加 extern "C" 后函数才能被 C 文件调用
C++ 支持重载，编译器会把函数名改成带参数类型信息的内部符号（比如 _Z3addii），而 C 编译器只认原始名（比如 add）。不加 extern "C"，链接时就找不到符号。
- 只在声明处加，定义处不用重复写（定义在 .cpp 里照常写，只要声明在头文件或 extern 块里包裹了就行）
- 如果头文件要同时被 C 和 C++ 包含，得用
#ifdef __cplusplus包一层，否则 C 编译器会报错不认识extern "C" -
extern "C"块内不能有 C++ 特性：比如模板、类、重载函数、默认参数——这些都会被编译器拒绝
extern "C" 怎么写才不会在头文件里翻车
典型错误是直接在头文件顶部加 extern "C" { ... }，结果 C 文件包含时报语法错误；或者忘了条件编译，导致 C++ 模块里声明失效。
- 标准写法是：
#ifdef __cplusplus extern "C" { #endif void do_work(int x); #ifdef __cplusplus } #endif - 如果头文件只给 C++ 用，但想导出 C 风格接口（比如供 Python ctypes 调用），也得加，否则动态库里的符号还是 mangled 的
- 注意：
extern "C"只影响链接符号名，不影响调用约定（如__stdcall）或 ABI 兼容性，Windows 上还得额外确认调用约定一致
链接时报 undefined reference to 'xxx' 的真实原因
这个错误看起来像没实现函数，但大概率是符号名对不上——C++ 定义了 void foo()，C 文件里声明成 extern void foo();，却没加 extern "C"，结果链接器找的是 _Z3foov，而 C 文件请求的是 foo。
立即学习“C++免费学习笔记（深入）”；
- 用
nm -C your_object.o（Linux/macOS）或dumpbin /symbols（Windows）看目标文件里实际导出的符号名 - 如果 C++ 目标文件里显示的是 mangled 名，但 C 代码期望的是 plain name，基本就是漏了
extern "C"声明 - 静态库（.a/.lib）打包时，如果源码没用
extern "C"，整个库对外都是 C++ 符号，没法被 C 工程直接链接
最容易被忽略的一点：extern "C" 是链接属性，不是语言属性。它不改变函数怎么执行，只决定链接器怎么找它——所以哪怕你用 C++ 写了 100 行逻辑，只要声明对了，C 代码就能干净地调进去。反过来，如果声明漏了、头文件没保护、或者混用了 inline 和 extern "C"，链接失败几乎必然发生，而且错误信息根本不提“名字修饰”这回事。
