Clang未导出C++符号：CMake构建共享库链接异常排查

从你提供的编译命令里能找到关键线索：-fvisibility hidden和-fvisibility-inlines-hidden这两个编译选项。它们会把所有C++符号默认标记为内部链接（隐藏状态），只有显式声明为对外可见的符号才会被导出到共享库中。这就是Test::Test()在最终库中无法对外可见的核心原因——它没有被标记为需要暴露给外部调用的符号。

你提到目标文件（.o）里符号是可见的，这是因为目标文件里的符号只是被标记了hidden属性，还没到链接阶段的导出筛选；当链接成共享库时，只有标记为default可见性的符号才会被保留为外部可见状态。

方案一：显式标记需要导出的类/函数（推荐） #

这是大型项目的标准实践，既能精准控制符号导出范围，又能避免符号冲突、减小库体积。在头文件中给需要对外暴露的类添加可见性属性：

#pragma once
// 标记Test类为对外可见
class __attribute__((visibility("default"))) Test {
public:
    Test();
};

如果需要跨平台兼容（比如Windows的DLL导出场景），可以用宏统一管理：

#pragma once
#ifdef _WIN32
    #ifdef examplelib_EXPORTS
        #define EXAMPLELIB_API __declspec(dllexport)
    #else
        #define EXAMPLELIB_API __declspec(dllimport)
    #endif
#else
    #define EXAMPLELIB_API __attribute__((visibility("default")))
#endif

class EXAMPLELIB_API Test {
public:
    Test();
};

注：CMake会自动给共享库目标定义${PROJECT_NAME}_EXPORTS宏，这里的examplelib_EXPORTS对应你的库名。

方案二：修改CMake配置，取消默认符号隐藏（适合小型项目） #

如果你不需要严格控制符号导出，可以在CMakeLists.txt中调整可见性预设：

// 取消默认隐藏，让所有符号对外可见
set(CMAKE_CXX_VISIBILITY_PRESET default)
set(CMAKE_VISIBILITY_INLINES_HIDDEN OFF)

不过不推荐在大型项目中使用这种方式，因为会导出大量不必要的符号，增加库体积和潜在的符号冲突风险。

重新编译库后，执行nm -gC libexamplelib.so，你应该能看到Test::Test()的符号出现在输出结果中，调用程序的链接错误也会随之解决。

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