CMake项目使用外部.so库和头文件时出现未定义引用错误如何解决？

问题核心原因 #

你遇到的链接错误本质是C++名字修饰（Name Mangling）导致的符号不匹配：

• 共享库libhello.so是基于C语言源码编译生成的，符号表中是C语言风格的无修饰符号hello()（可通过nm输出确认）。
• 你的main.cpp是C代码，编译器会对hello()函数名进行C风格的名字修饰，生成类似_Z5hellov的符号，链接时无法在库中找到匹配项，因此报错。

两种解决方法 #

方法1：修改头文件添加C语言链接声明 #

在hello.h中加入extern "C"条件编译块，让C++编译器以C语言规则处理该函数的声明：

#pragma once

#ifdef __cplusplus
extern "C" {
#endif

void hello(void);

#ifdef __cplusplus
}
#endif

方法2：在C++代码中显式声明C语言链接 #

如果无法修改第三方库的头文件，可在main.cpp中包裹头文件引用：

extern "C" {
#include "hello.h"
}

int main(void)
{
    hello();
    return 0;
}

验证修改效果 #

重新执行构建流程：

cd build
make clean
cmake ..
make
./index

此时链接会成功，运行程序将输出Hello world!。

补充说明 #

这类问题在C项目调用C语言编写的第三方库时非常普遍，比如你提到的Chromium Embedded Framework（CEF）也是C/C混合实现的库，使用时同样需要注意通过extern "C"来保证符号匹配。

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