为何共享对象含@GLIBCXX版本符号？如何降低libstdc++版本依赖？

问题背景 #

我正在构建一个输出为.so文件的库，执行nm -u命令查看该库时，得到以下结果：

nm -u libmycodec.so | grep invalid_argument
                 U _ZNSt16invalid_argumentC1EPKc
                 U _ZNSt16invalid_argumentC1ERKSs@GLIBCXX_3.4
                 U _ZNSt16invalid_argumentD1Ev@GLIBCXX_3.4
                 U _ZSt24__throw_invalid_argumentPKc@GLIBCXX_3.4
                 U _ZTISt16invalid_argument@GLIBCXX_3.4

但系统中另一个.so文件（如PyTorch的libtorch.so）却没有版本化符号，执行命令结果如下：

nm -u libtorch.so | grep invalid_argument
                 U _ZNSt16invalid_argumentD1Ev
                 U _ZTVSt16invalid_argument

已知带版本的GLIBCXX符号会让.so文件对用户系统上的libstdc++.so版本有严格要求，这类符号存在是为了避免加载旧版本.so（可能因修复bug）。想了解以下问题：

• 为何像libtorch.so这类现代库会避免使用版本化符号？
• 如何让我的.so文件降低对libstdc++.so版本的依赖？是否需要组合使用编译器和链接器标志？
• 除了静态链接libstdc++（可能导致.so体积膨胀），还有其他方法吗？

解答 #

1. 为什么libtorch这类现代库避免版本化符号？ #

核心是主动控制兼容性范围：

• 这类库会刻意选择链接libstdc++的基础符号版本，而非依赖高版本新增符号；或者通过符号隐藏、接口封装，把C++标准库的依赖内部化，对外只暴露稳定的自定义接口，避免直接暴露标准库的版本化符号。
• 多数现代库会采用ABI兼容编译策略：比如指定较低的C标准（如C11/C++14），同时用_GLIBCXX_USE_CXX11_ABI=0宏强制使用旧ABI，避免生成绑定高版本GLIBCXX标签的符号。
• 部分库会通过链接脚本、strip或objcopy工具移除版本信息，或者在编译阶段就避免生成带版本的符号引用。

2. 如何降低自己的SO库对libstdc++.so的版本依赖？ #

需要组合使用编译器和链接器标志，核心思路是强制兼容旧ABI、避免高版本符号引用、隐藏不必要符号：

编译器标志：

• 指定较低C标准：比如-std=c++11或-std=c++14，避开C17/C++20新增的标准库特性（这类特性通常绑定高版本GLIBCXX符号）。
• 强制旧ABI：添加-D_GLIBCXX_USE_CXX11_ABI=0（仅GCC 5+有效，让标准库使用C++11前的ABI，避免生成带高版本GLIBCXX标签的符号）。
• 符号隐藏：添加-fvisibility=hidden，默认隐藏所有符号，仅通过__attribute__((visibility("default")))标记需要导出的接口，避免标准库符号意外暴露到动态符号表。

链接器标志：

• 使用版本脚本：通过-Wl,--version-script=version.map指定仅导出自身符号，过滤标准库符号。示例版本脚本：

  {
      global:
          my_exported_function;
          MyExportedClass;
      local:
          *;
  };
  

  该脚本会让链接器仅保留指定的全局符号，其余符号（含标准库）设为局部，不会出现在动态符号表中，消除版本化依赖。
• 添加-Wl,--as-needed：让链接器仅链接实际需要的库，减少不必要的高版本libstdc++符号引用。
• 辅助检查：添加-Wl,--no-undefined，确保所有符号可解析，避免运行时未定义符号错误。

3. 除了静态链接libstdc++，还有其他方法吗？ #

有多种替代方案：

• 封装C接口：将C功能封装为纯C接口，对外仅暴露C函数，动态符号表中只会有C符号，完全规避C标准库的符号依赖，兼容性极强。
• 切换clang/libc++编译：使用clang编译器并添加-stdlib=libc++，生成的SO会依赖libc++.so，其版本化符号策略兼容性更好，也可选择静态链接libc++（体积膨胀比libstdc++小）。
• 工具修改符号版本：用patchelf或objcopy移除SO中的版本化符号标签，示例命令：

  patchelf --remove-symbol-version=_ZNSt16invalid_argumentC1ERKSs libmycodec.so
  

  注意：这种方式有风险，可能导致运行时符号解析错误，需充分测试。
• 指定旧版libstdc++路径：编译时添加-Wl,-rpath=/path/to/old/libstdc++，但要求用户环境也存在该路径，通用性较差。

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