根本原因是C++编译器默认进行name mangling而C库符号未修饰，解决方法是用extern "C"包裹C头文件声明。
为什么C++链接C静态库会报“undefined reference”
根本原因是C++编译器默认对函数名做name mangling（名字修饰），而C编译器生成的符号是未经修饰的纯函数名。链接时，g++找的是类似 _Z3fooi 这样的符号，但静态库中存的是 foo，自然找不到。
解决办法不是改库，而是告诉C++编译器：“这段声明是C风格的，别修饰名字”。必须用 extern "C" 包裹头文件包含或函数声明。
- 只对声明起作用，不影响实现文件（.c文件本身不用改）
- 不能只包函数定义，必须包声明——也就是你#include的头文件内容
- 如果头文件由C项目提供，且没加
#ifdef __cplusplus保护，你就得手动包住#include
如何正确包含C头文件并链接libxxx.a
假设你有一个C静态库 libmathutil.a，配套头文件是 mathutil.h，里面声明了 int add(int a, int b);。
在C++源文件中，这么写才是安全的：
立即学习“C语言免费学习笔记（深入）”；
extern "C" {
#include "mathutil.h"
}
然后编译链接命令要同时指定头文件路径和库路径：
g++ -I/path/to/include main.cpp -L/path/to/lib -lmathutil -o app-
-I告诉编译器去哪找mathutil.h，-L告诉链接器去哪找libmathutil.a -
-lmathutil中的lib和.a是自动补全的，不能写成-lmathutil.a
静态库内部有全局变量怎么办
C静态库里的全局变量（比如 int global_counter;）同样受C linkage约束。如果C++代码想访问它，声明时也得用 extern "C" 修饰：
extern "C" {
extern int global_counter;
}
否则即使链接通过，运行时读到的可能是未初始化的垃圾值——因为C++可能把它当成了另一个同名但mangled的变量。
- 不加
extern "C"声明全局变量，是比函数更隐蔽的坑 - 变量声明必须带
extern关键字，否则会被当作定义，导致多重定义错误 - 如果C库头文件里已经用
#ifdef __cplusplus包好了变量声明，那你直接 include 就行
用CMake链接C静态库的常见漏项
CMake默认把所有target当C++处理，所以即使你用 target_link_libraries(myapp mathutil)，链接阶段仍可能失败——因为没告诉编译器头文件要用C linkage。
正确做法分两步：
- 用
find_path()和find_library()正确定位头文件和.a路径 - 在
target_include_directories()之前，确保C++源文件包含头文件时被extern "C"覆盖——最稳的方式仍是手动包裹#include - 不要依赖
set_property(GLOBAL PROPERTY TARGET_SUPPORTS_SHARED_LIBS FALSE)，这跟linkage无关
真正容易被忽略的是：CMake本身不处理 extern "C"，它只是调用编译器。该加的括号，一行都不能少。
