跨平台CMake中generate_export_headers与内联模板函数的使用

核心逻辑 #

这两项要求其实并不矛盾——CMAKE_CXX_VISIBILITY_PRESET和CMAKE_VISIBILITY_INLINES_HIDDEN仅对GCC/Clang生效，MSVC会直接忽略这两个配置，所以可以放心全局开启，再通过条件分支处理不同编译器的导出规则即可。

具体实现步骤 #

1. 保留CMake全局可见性配置 #

在CMakeLists.txt顶部照常设置：

set(CMAKE_CXX_VISIBILITY_PRESET hidden)
set(CMAKE_VISIBILITY_INLINES_HIDDEN 1)

这两个选项不会干扰MSVC的模板处理逻辑，仅在GCC/Clang环境下生效，实现内联符号隐藏的最佳实践。

2. 编写编译器感知的导出宏 #

可以手动编写导出头文件，或者借助CMake的GenerateExportHeader模块自动生成，核心是针对MSVC和GCC/Clang做分支处理：

#ifdef _MSC_VER
// MSVC不支持模板的DLL导出/导入语义，直接使用空宏
#define MYLIB_EXPORT
#else
// GCC/Clang下用可见性修饰符控制符号暴露
#ifdef MYLIB_BUILDING_LIBRARY
#define MYLIB_EXPORT __attribute__((visibility("default")))
#else
#define MYLIB_EXPORT __attribute__((visibility("default")))
#endif
#endif

如果用CMake自动生成导出头，只需添加以下配置，CMake会帮你处理基础的宏分支：

include(GenerateExportHeader)
generate_export_header(MyLib
    BASE_NAME MyLib
    EXPORT_MACRO_NAME MYLIB_EXPORT
    EXPORT_FILE_NAME MyLibExport.h
)

3. 模板代码的标注方式 #

给需要对外暴露的模板类/函数添加MYLIB_EXPORT宏：

// 对外可见的模板类
MYLIB_EXPORT template<typename T>
class MyTemplateClass {
    // ...
};

// 对外可见的模板函数
MYLIB_EXPORT template<typename T>
T add(T a, T b) {
    return a + b;
}

• 对GCC/Clang：宏会将模板符号可见性设为default，覆盖全局hidden预设，确保外部可访问。
• 对MSVC：宏为空，符合其不支持模板DLL导出的规则，编译器会自动处理模板实例化的可见性。

额外注意事项 #

• MSVC的显式模板实例化：如果你的库内部实例化了常用类型的模板（比如MyTemplateClass<int>），需要在MSVC下显式标记导出，避免外部用户重复实例化：

  #ifdef _MSC_VER
  template class MYLIB_EXPORT MyTemplateClass<int>;
  template MYLIB_EXPORT int add<int>(int, int);
  #endif
  

• 控制导出范围：仅给需要对外暴露的模板添加MYLIB_EXPORT，内部模板保持全局hidden默认设置，减少符号表体积。

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