C++调用C函数报“undefined reference”是因为C++编译器对函数名进行name mangling，而C编译器生成简单符号名，导致链接时符号不匹配；需用extern "C"声明告知C++编译器按C链接规范处理。
为什么 C++ 直接调用 C 函数会报 “undefined reference”
因为 C++ 编译器默认对函数名做 name mangling（名称修饰），比如 void foo(int) 可能被编译成 _Z3fooi 这样的符号；而 C 编译器生成的符号就是简单的 foo。链接器找不到匹配的符号，就报 undefined reference to 'foo'。
这不是头文件没包含、也不是库没链接的问题——是符号名根本对不上。
- 典型错误现象：
undefined reference to 'read_config'，但你确认read_config在libcfg.a里，且已用-lcfg链接 - 用
nm libcfg.a | c++filt查看实际导出符号：C 库里是T read_config，而 C++ 目标文件里在找U _Z12read_configv - 根本原因：C++ 源码里没告诉编译器“这个函数是按 C 的规则命名的”
extern "C" 必须加在声明处，不是定义处
extern "C" 的作用是告诉 C++ 编译器：“接下来的声明，按 C 的链接规范处理”，它只影响**函数声明的可见性**，不改变实现逻辑。所以它必须出现在 C++ 代码中对 C 函数的声明位置（通常是头文件或源文件顶部），而不是 C 源文件里。
常见错误写法：
— 在 C 的 utils.h 里直接写 extern "C" void log_msg(const char*); → C 编译器不认识 extern "C"，编译失败
— 在 C++ 源文件里只在调用前写 extern "C" { void log_msg(const char*); }，但忘了加 {} 包裹 → 语法错误
- 正确做法：C 头文件用宏保护 + 条件编译
#ifdef __cplusplus
extern "C" {
#endif
void read_config(const char path);
int parse_int(const char s);
ifdef __cplusplus
}
立即学习“C语言免费学习笔记（深入）”；
endif
- 如果你没有 C 头文件控制权（比如用系统库
extern "C" {
#include
#include
} - 注意：
extern "C"块内不能出现 C++ 特有语法（如模板、重载、std::string参数）
静态库和动态库对 extern "C" 的要求是一样的
无论你链接的是 libmath.a 还是 libmath.so，只要它是用 C 编译器（gcc）编译的，里面的符号就是 C 风格的；C++ 调用时就必须用 extern "C" 声明来对齐链接规范。链接器不关心库是静态还是动态，只认符号名。
- 验证方式：
nm -D libmath.so | grep init_table（动态库用-D看动态符号），如果输出是T init_table，说明是 C 符号；若看到U _Z10init_tablev，那其实是 C++ 编译出来的 - 混合项目中，如果 C++ 实现的函数要被 C 代码调用，也得在 C++ 里用
extern "C"声明并定义（且不能含 C++ 类型） - 动态库导出控制（如 Windows 的
__declspec(dllexport)或 Linux 的__attribute__((visibility("default")))）是另一层问题，不影响extern "C"的必要性
extern "C" 不能解决类型不兼容问题
extern "C" 只管符号名和调用约定（calling convention），不管参数/返回值类型是否可互操作。比如 C 头文件里写了 void process(struct Data* d);，而你在 C++ 里传了 std::unique_ptr，编译器会直接报错——这不是链接问题，是类型系统层面的不匹配。
- C 结构体在 C++ 中可用，但若有 C99 的灵活数组成员（如
int data[];），C++20 才支持，老标准需用int data[1];兼容写法 - C 的
bool（来自_Bool，C++ 的bool是独立类型，混用可能引发隐式转换警告甚至行为差异 - 最稳妥的做法：C 接口一律使用 POD 类型（
int、char*、纯 C struct）、避免指针别名歧义（如用const char*而非char*表达只读语义）
真正容易被忽略的是：extern "C" 加了，链接通过了，运行时却崩在第三帧——往往是因为结构体内存布局不一致，或者 C 函数内部把 char* 当作了以 \0 结尾字符串，而你传入的是二进制数据且中间含 \0。
