根本原因是-fvisibility=hidden仅设置编译阶段默认可见性，不直接控制链接时符号导出；它使未显式标注的符号默认为STB_LOCAL，但显式属性或链接器行为可覆盖，且静态库符号可见性不影响归档，真正决定动态符号表内容的是-fvisibility配合__attribute__((visibility("default")))或链接器脚本。
为什么-fvisibility=hidden不生效？
根本原因不是参数没写对，而是-fvisibility只影响编译阶段生成的目标文件（.o），对链接时的符号可见性无直接控制。它不改变已定义符号的导出行为，只设置“默认可见性”，而显式声明（如__attribute__((visibility("default")))）或链接器脚本仍可覆盖它。
常见误判场景：你加了-fvisibility=hidden，但nm -C libfoo.a | grep my_func仍看到T（全局符号），就以为失效——其实这只是说明该符号被标记为“可被外部引用”，不代表它一定被动态导出。真正决定是否出现在动态符号表（readelf -d libfoo.so | grep SONAME）的是-fvisibility配合__attribute__或visibility链接选项。
-
-fvisibility=hidden让所有未显式标注的函数/变量默认为STB_LOCAL（仅本模块可见） -
-fvisibility=default恢复GCC传统行为（全部默认导出） - 必须配合
__attribute__((visibility("default")))手动放开需要导出的符号 - 静态库（.a）中符号是否“可见”不影响归档，只影响后续链接时能否被选中
如何确保.so里只导出指定函数？
仅靠-fvisibility=hidden不够，必须组合使用符号版本脚本（version script）或visibility属性。否则即使函数被标记为hidden，若被其他目标文件直接引用，链接器仍可能将其提升为全局符号。
推荐做法是双保险：
- 编译时统一加
-fvisibility=hidden - 在头文件中用宏封装导出声明：
#define API_EXPORT __attribute__((visibility("default"))) - 实现文件中只对真正需要对外暴露的函数加
API_EXPORT，例如：API_EXPORT int init_library(); - 构建共享库时追加
-Wl,--exclude-libs,ALL防止静态库内符号污染
验证方式：objdump -T libmylib.so | grep -E "init_library|helper_internal"，前者应出现，后者不应出现。
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
与C++类成员函数的 visibility 冲突怎么处理？
C++类的成员函数默认继承类的可见性，但模板实例化、内联函数、虚函数表（vtable）容易绕过-fvisibility控制。尤其虚函数，即使类声明加了visibility("hidden")，其vtable和RTTI信息仍可能被导出。
关键点：
- 虚函数必须显式标注
__attribute__((visibility("default")))才能被外部调用，否则链接时报undefined reference - 模板函数默认不导出，除非显式实例化并标注
API_EXPORT - 内联函数若在头文件中定义且未标注，即使
-fvisibility=hidden也无效——因为它们在每个TU里重复生成 - 建议将C++接口封装为纯C风格的
extern "C"函数，彻底规避name mangling和visibility歧义
Clang下-fvisibility和模块（module）共存时谁优先？
模块（.cppm）本身不参与-fvisibility控制流程。模块导出的符号由export声明决定，与visibility属性无关；而模块导入后生成的代码，在编译成目标文件时才受-fvisibility影响。
也就是说：
- 模块接口单元（IMPU）中的
export函数，无论是否加visibility("default")，都会被导出 - 模块内部非
export的辅助函数，即使加了visibility("default")，也不会出现在模块接口中 - 若模块被编译为共享库（
clang++ -shared -fmodules ...），则最终so的符号导出仍需靠-fvisibility+__attribute__控制模块外的C兼容接口
实际项目中，模块用于逻辑封装，-fvisibility用于二进制分发控制——两者职责不同，但边界容易模糊。最容易被忽略的是：模块导出的函数若通过C ABI暴露，仍需额外加extern "C"和visibility("default")，否则C端无法链接。
