95、统一符号可见性：设置VISIBILITY_INLINES_HIDDEN和CXX_VISIBILITY_PRESET

符号可见性这个话题，说实话，很多C++开发者一开始都不太在意。我早年做项目时也是这样——直到有一次，一个动态库在Linux上链接后，运行时疯狂报符号冲突，我才意识到这玩意儿有多重要。

今天咱们就聊聊CMake里两个控制符号可见性的关键变量：VISIBILITY_INLINES_HIDDEN和CXX_VISIBILITY_PRESET。说白了，它们就是帮你管好动态库的“门禁系统”，哪些符号该暴露，哪些该藏起来，全由它们说了算。

为什么需要控制符号可见性？

先问个问题：你写了一个动态库，里面有一堆内部函数，你希望外部调用者看到哪些？

默认情况下，GCC和Clang会把所有符号都导出。这意味着你的内部实现细节全部暴露在外。我遇到过的情况是：两个不同的动态库都定义了同名的辅助函数，结果链接时冲突，程序崩溃得一塌糊涂。

控制符号可见性可以带来三个好处：

• 减少符号冲突——内部函数不会污染全局命名空间
• 减小动态库体积——不导出的符号不会被动态链接器处理
• 提升运行时性能——符号表小了，加载速度自然快

CXX_VISIBILITY_PRESET：控制函数和变量的可见性

这个变量决定了编译C++代码时，默认的符号可见性是什么。它对应编译器的 -fvisibility= 参数。

可选的取值有两个：

我个人习惯设置为 hidden。为什么呢？因为这样你就要主动用 __attribute__((visibility("default"))) 或 dllexport 来标记你想导出的符号。说白了，就是“白名单机制”——只有你明确说“我要导出”的符号才会暴露出去。

# 推荐做法：默认隐藏所有符号
set(CMAKE_CXX_VISIBILITY_PRESET hidden)

# 然后在代码中，只对接口类或函数标记导出
class __attribute__((visibility("default"))) MyPublicClass {
    // 这个类会被导出
};

void __attribute__((visibility("default"))) publicFunction() {
    // 这个函数会被导出
}

// 未标记的都不会被导出
void internalHelper() {
    // 这个函数对外不可见
}

#if defined(_MSC_VER)
  #define EXPORT __declspec(dllexport)
#else
  #define EXPORT __attribute__((visibility("default")))
#endif

class EXPORT MyClass { };

VISIBILITY_INLINES_HIDDEN：控制内联函数的可见性

这个变量专门针对内联函数。它对应编译器的 -fvisibility-inlines-hidden 参数。

设置为 ON 时，所有内联函数都会被隐藏。为什么需要这个？

你想想看，内联函数通常定义在头文件里。如果两个动态库都包含了同一个头文件，并且都编译了同一个内联函数，那么这两个动态库里都会有这个函数的副本。如果不隐藏，链接时就会产生重复符号。

# 隐藏所有内联函数
set(CMAKE_VISIBILITY_INLINES_HIDDEN ON)

实战配置：完整的符号可见性方案

把两个变量结合起来，就是一套完整的符号可见性控制方案。我在项目中通常这样配置：

# 设置C++符号可见性
set(CMAKE_CXX_VISIBILITY_PRESET hidden)
set(CMAKE_VISIBILITY_INLINES_HIDDEN ON)

# 如果是C项目，也要设置
set(CMAKE_C_VISIBILITY_PRESET hidden)

# 确保这些设置在 add_library 之前生效
add_library(mylib SHARED
    src/public_api.cpp
    src/internal_impl.cpp
)

这套配置的效果是：

• 所有函数和变量默认隐藏
• 所有内联函数默认隐藏
• 只有显式标记 visibility("default") 的符号才会被导出

我曾经踩过的坑

讲两个我亲身经历的问题，希望能帮你避坑：

坑一：忘记设置顺序

我曾经在 add_library 之后才设置这两个变量。结果编译出来的动态库符号全部暴露了。因为CMake在 add_library 时就已经读取了这些变量的值，后续修改不会影响已经创建的目标。

坑二：Windows上的差异

在Windows上用MSVC编译时，CMAKE_CXX_VISIBILITY_PRESET 是不生效的。因为MSVC默认就是隐藏所有符号，你需要用 __declspec(dllexport) 来显式导出。所以跨平台项目要特别注意这一点。

知识体系总览

下面这张图帮你理清这两个变量的关系和作用范围：

总结一下

这两个变量虽然简单，但用好它们能让你的动态库更干净、更安全。我个人的建议是：

• 新项目一律设置 CMAKE_CXX_VISIBILITY_PRESET hidden
• 同时开启 CMAKE_VISIBILITY_INLINES_HIDDEN ON
• 用宏封装可见性属性，方便跨平台
• 在 add_library 之前完成所有设置

记住一句话：动态库的接口越少，维护成本越低。把该藏的藏好，你的代码质量会上一个台阶。