CMake下.so共享库符号导出的机制与配置问题咨询

1. add_library 和 target_link_libraries 对符号导出的作用 #

add_library(library SHARED ...) 是创建共享库的核心命令，它定义了库的类型为共享库——只有共享库才存在符号导出的需求（静态库无需导出符号），但它本身不直接控制哪些符号会被导出。

target_link_libraries 仅负责将依赖库链接到当前共享库中，和符号导出没有直接关系，它不会主动导出依赖库的符号，也不影响当前库自身符号的导出规则。

符号导出的实际行为默认由编译器规则决定（比如GCC默认导出所有非全局静态的符号），后续可通过CMake选项或代码标记来调整。

2. 如何阻止特定文件或库的符号导出 #

完全可以通过CMake设置或代码标记实现：

• 单个cpp文件：
  • 给目标文件添加编译选项，强制隐藏默认符号，仅保留显式标记的符号：

    set_source_files_properties(file1.cpp PROPERTIES COMPILE_FLAGS "-fvisibility=hidden")
    

    然后在需要导出的函数/类前添加编译器属性，比如GCC下的__attribute__((visibility("default")))；
  • 在代码中用static修饰符号，使其仅在当前文件可见，不会被导出。
• 整个库：
  • 使用CMake属性统一设置默认隐藏所有符号：

    set_target_properties(library PROPERTIES
      CXX_VISIBILITY_PRESET hidden
      VISIBILITY_INLINES_HIDDEN ON
    )
    

    之后仅需给需要导出的符号添加显式标记即可；
  • 也可以直接给整个库添加编译选项：

    target_compile_options(library PRIVATE -fvisibility=hidden)
    

3. 其他用于符号导出的CMake函数/命令 #

除了add_library，还有以下常用方式：

• set_target_properties：配合EXPORTED_SYMBOLS属性（部分平台如macOS支持），可以指定具体要导出的符号列表；也可以用LINK_FLAGS属性传递链接器选项来控制符号。
• generate_export_header：来自CMake的GenerateExportHeader模块，可自动生成跨平台的导出宏（适配Windows的__declspec(dllexport)/__declspec(dllimport)、Linux的可见性属性等），简化代码中的符号导出标记，用法示例：

  include(GenerateExportHeader)
  generate_export_header(library
    BASE_NAME library
    EXPORT_MACRO_NAME LIBRARY_EXPORT
    EXPORT_FILE_NAME library_export.h
  )
  

• target_link_options：可以传递链接器脚本选项（比如Linux下的-Wl,--version-script=export.lds），通过链接器脚本精确控制哪些符号被导出。

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