C++调用C函数报“undefined reference”的根本原因是C++编译器进行name mangling而C不修饰函数名，解决方法是在C++中用extern "C"声明C函数以禁用名字修饰。
为什么C++调用C函数会报“undefined reference”
根本原因是C++编译器对函数名做了name mangling（名字修饰），而C编译器只用原始函数名。比如C里写void init()，C++编译后可能变成_Z4initv，链接时自然找不到C目标文件里的init符号。
解决办法不是改C代码，而是告诉C++编译器：“这段声明按C的规则处理”。关键就在extern "C"——它禁用C++的名字修饰，让链接器能对上号。
- 必须放在C++源码中（.cpp或头文件被.cpp包含时），不能放在C文件里
- 如果头文件同时被C和C++代码包含，得用
#ifdef __cplusplus做条件包裹，否则C编译器不认识extern "C" - 不要只包函数声明，结构体、枚举、宏定义这些不用加；只有函数和全局变量需要
C头文件被C++代码包含时的标准写法
这是最常见也最容易出错的场景：你写了个utils.h给C用，现在C++项目也要用它。直接#include会导致C++编译失败或链接失败。
正确做法是在C头文件开头结尾加保护宏：
立即学习“C++免费学习笔记（深入）”；
#ifdef __cplusplus
extern "C" {
#endif
<p>void do_work(int x);
int get_status();</p><h1>ifdef __cplusplus</h1><p>}</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/gongju/2823" title="C++14"><img
src="https://img.php.cn/upload/manual/001/431/639/6ac8b33c327c4749.png" alt="C++14" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/gongju/2823" title="C++14">C++14</a>
<p>C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。</p>
</div>
<a href="/xiazai/gongju/2823" title="C++14" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><h1>endif</h1><p>注意：__cplusplus是C++编译器预定义宏，C编译器没有这个宏，所以中间的声明对C完全透明；而C++看到extern "C"块，就按C链接约定处理里面的内容。
- 别漏掉
#endif配对，否则整个后续头文件都会被误判为C链接 - 如果头文件里有内联函数（
static inline），它们不受extern "C"影响，可以不管 - 不建议在C++源文件里用
extern "C" { #include "utils.h" }——这会让头文件失去C兼容性，维护成本高
extern "C"能否用于C++类成员函数
不能。C语言没有类、this指针、虚函数表这些概念，extern "C"只适用于自由函数和全局变量。
如果你非要从C代码里调用某个C++功能，得额外写一层C风格的包装函数：
// wrapper.cpp
#include "MyClass.h"
<p>// C++实现
MyClass<em> create_instance() { return new MyClass(); }
void destroy_instance(MyClass</em> obj) { delete obj; }
int run_task(MyClass* obj, int input) { return obj->process(input); }</p><p>// 暴露给C的接口
extern "C" {
MyClass<em> myclass_create() { return create_instance(); }
void myclass_destroy(MyClass</em> obj) { destroy_instance(obj); }
int myclass_run(MyClass* obj, int input) { return run_task(obj, input); }
}
- 包装函数参数只能是C基本类型或指针（包括
void*），不能传std::string、std::vector等 - 所有资源生命周期必须由C代码明确管理（比如C调用
myclass_create后，必须记得调用myclass_destroy） - 别试图把C++异常透出到C层——C没异常机制，一旦C++抛异常且未被捕获，程序直接终止
链接时出现multiple definition错误怎么办
典型现象：多个.o文件都定义了同一个extern "C"函数，比如你在两个.cpp里都写了extern "C" int helper() { return 42; }，链接时报multiple definition of 'helper'。
原因很简单：extern "C"只管链接约定，不管定义唯一性。它和普通C函数一样，定义只能有一处。
- 函数实现必须放在单独的.c或.cpp里（推荐.c，保持纯C语义）
- 头文件里只放
extern "C"声明，不放定义；定义留在源文件 - 如果真要内联，用
static extern "C"，但这样每个翻译单元一份副本，不共享状态 - 检查是否不小心把
.c文件当.cpp编译了——C++编译器会把它当C++代码处理，导致重复符号
混合编程最难的从来不是语法，而是谁负责内存、谁触发销毁、谁捕获错误。这些边界一旦模糊，调试时连core dump都看不出是C还是C++崩的。
