C/C++链接错误：undefined reference to `BMWIntegrationTest_RunTestSuite'

常见原因及修复方案 #

1. 编译时未包含foo.c文件 #

这是最常见的问题——如果编译命令只处理了main.c，没把foo.c加入编译流程，链接器找不到函数的实现代码，就会报未定义引用。

• 修复：将所有源文件都包含在编译命令中。比如使用GCC编译：

  gcc main.c foo.c -o test_program
  

  若使用Makefile，需确保foo.o被列为最终可执行文件的依赖项：

  test_program: main.o foo.o
      gcc main.o foo.o -o test_program
  main.o: main.c foo.h
      gcc -c main.c
  foo.o: foo.c foo.h
      gcc -c foo.c
  

2. C/C++混合编译的名字修饰冲突 #

如果main.c实际按C规则编译（比如后缀是.cpp，或编译器默认启用C编译），而foo.c是纯C实现，C++的名字修饰机制会改变函数名，导致链接器无法识别C风格的函数定义。

• 修复：在foo.h中添加C兼容声明，让C++编译器按C规则处理该函数：

  #ifndef FOO_H
  #define FOO_H
  
  #ifdef __cplusplus
  extern "C" {
  #endif
  
  void BMWIntegrationTest_RunTestSuite();
  
  #ifdef __cplusplus
  }
  #endif
  
  #endif // FOO_H
  

3. 函数声明与实现签名不匹配 #

仔细核对foo.h的函数声明和foo.c中的实现：函数名拼写、返回值类型、参数列表必须完全一致。比如C语言中void func()和void func(void)是不同的（前者表示参数数量未知，后者表示无参数），签名不一致会导致链接器无法匹配。

• 修复：统一声明和实现的签名，例如声明写void BMWIntegrationTest_RunTestSuite(void);，实现也对应保持一致。

4. 函数被static修饰 #

如果foo.c里的函数定义加了static关键字，该函数会被限制为仅在foo.c内部可见，其他文件调用时链接器无法找到它。

• 修复：去掉static修饰，让函数变为全局可见：

  // 错误写法
  static void BMWIntegrationTest_RunTestSuite() {
      // 函数实现
  }
  
  // 正确写法
  void BMWIntegrationTest_RunTestSuite() {
      // 函数实现
  }
  

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