根本原因是C++编译器进行name mangling而C编译器不修饰函数名，导致链接时符号不匹配；需在C++中用extern “C”声明C函数，且声明与定义必须完全一致。
为什么 C++ 调用 C 函数时会链接失败？
根本原因是 C++ 编译器对函数名做了 name mangling（名称修饰），而 C 编译器只用原始函数名。比如 C 文件里定义的 void init()，C++ 目标文件里可能变成 _Z4initv，链接器自然找不到 init 符号。
extern “C” 必须加在声明处，不是定义处
它只影响编译器对函数名的处理方式，不改变实现逻辑。常见错误是只在 C 文件的定义前加 extern "C"，这毫无作用——C 编译器根本不认识这个语法。
正确做法是：在 C++ 代码中包含 C 头文件时，用 extern "C" 包裹声明：
#ifdef __cplusplus
extern "C" {
#endif
void process_data(int*, size_t);
int get_version();
#ifdef __cplusplus
}
#endif
或者更稳妥地，在 C 头文件顶部就加上保护：
立即学习“C++免费学习笔记（深入）”；
#ifndef MY_C_HEADER_H
#define MY_C_HEADER_H
#ifdef __cplusplus
extern "C" {
#endif
void process_data(int*, size_t);
int get_version();
#ifdef __cplusplus
}
#endif
#endif
C++ 中调用 C 函数时不能省略头文件包含
即使你手动写了 extern "C" void foo();，也必须确保该声明与 C 源文件中的定义完全一致（参数类型、const 限定、返回值），否则仍可能因类型不匹配导致运行时错误。
- C 函数参数为
int*，C++ 声明写成const int*→ 链接能过，但行为未定义 - C 函数返回
char*，C++ 声明写成const char*→ 编译报错：重载冲突或类型不匹配 - 忘记在 C++ 文件中
#include "c_api.h"，仅靠手工声明 → 缺少结构体定义或宏，编译失败
全局变量和回调函数也要加 extern “C”
不只是函数，所有需要跨语言访问的符号都受 name mangling 影响。比如 C 库导出一个函数指针类型的全局变量：
// C side (lib.c) void (*g_callback)(int) = NULL;
在 C++ 中使用它，必须同样用 extern "C" 声明：
extern "C" {
extern void (*g_callback)(int);
}
如果要向 C 库注册 C++ 成员函数作回调，必须提供一个 extern "C" 的静态包装函数，因为成员函数隐含 this 参数，签名天然不兼容 C 调用约定。
名称修饰问题不在链接阶段才暴露，而是在编译生成目标文件时就已经固化；一旦 C++ 源码里没用 extern "C" 声明，哪怕函数名拼写完全正确，链接器也只会搜 _Z8callbackv 这类符号，而不是你期望的 callback。