在C代码中调用含extern "C"声明的C++函数时遭遇编译致命错误

问题根源 #

当你用GCC编译C代码时，编译器会严格按照C语言的规则处理所有包含的头文件。此时__cplusplus宏不会被定义，所以头文件里的extern "C"包裹块会被跳过，但最顶部的#include <vector>会直接暴露给C编译器——而C标准库根本没有<vector>这个头文件（它是C++ STL专属的容器头），因此触发了“找不到文件”的致命错误。

简单来说：你的C头文件里混入了C++专属的依赖，而C编译器完全不认识这类内容。

解决方案：分离C接口与C++实现 #

要解决这个问题，核心是把供C调用的纯C接口和包含C++特性的实现代码彻底隔离，具体步骤如下：

1. 创建纯C兼容的接口头文件 #

新建一个只包含C语言兼容内容的头文件（比如test_c.h），里面只放函数的extern "C"声明，绝对不要包含任何C++头文件：

#ifndef TEST_C_H
#define TEST_C_H

// 让C++编译器识别extern "C"，同时不影响C编译器
#ifdef __cplusplus
extern "C" {
#endif

// 仅声明供C调用的函数
void test();

#ifdef __cplusplus
}
#endif

#endif // TEST_C_H

2. 修改C++实现文件 #

在你的C实现文件（比如test.cpp）里，包含刚才的C接口头文件，以及你需要的C头文件（比如<vector>），然后实现函数：

#include "test_c.h"
#include <vector>

void test() {
    // 这里可以正常使用vector等C++特性
    std::vector<int> demo_vec;
    demo_vec.push_back(123);
    // ... 你的业务逻辑
}

3. 修改C调用代码 #

让C代码只包含纯C接口头文件，不要碰原来的test.hpp：

#include "test_c.h"

// C标准里main函数应该返回int，建议修正
int main() {
    test();
    return 0;
}

4. 正确的编译与链接步骤 #

• 先用g编译C实现文件，生成目标文件：

  g++ -c test.cpp -o test.o
  

• 再用gcc编译C代码，生成目标文件：

  gcc -c main.c -o main.o
  

• 最后用g链接两个目标文件（g会自动链接C++标准库，避免链接错误）：

  g++ main.o test.o -o my_program
  

这样处理后，C编译器只会看到纯C的接口头文件，不会接触到任何C专属内容，而C实现里的vector依赖只会被g++处理，就能顺利编译通过了。

内容的提问来源于stack exchange，提问作者harry