CentOS7下devtoolset-11编译C++代码报list引用歧义错误求助

问题背景 #

在CentOS 7系统使用devtoolset-11编译C代码时，触发reference to 'list' is ambiguous错误，相同代码在AlmaLinux 9原生g 11环境下编译完全正常，且仅devtoolset系列工具链（测试过7、8、11版本）会出现该问题。

复现代码 #

#include <list>
namespace std{
  #ifdef _GLIBCXX_USE_CXX11_ABI
   #pragma message("Redefining list")
   inline namespace __cxx11 {
     template<class elem, class alloc> class list;
   }
  #endif
}


int main(){
        std::list<int> l;
        return 0;
}

注：该代码仅用于复现第三方库中的问题，请勿建议修改此代码结构

编译错误信息 #

test.cpp:4:37: note: '#pragma message: Redefining list'
    4 |    #pragma message("Redefining list")
      |                                     ^
test.cpp: In function 'int main()':
test.cpp:13:14: error: reference to 'list' is ambiguous
   13 |         std::list<int> l;
      |              ^~~~
test.cpp:6:46: note: candidates are: 'template<class elem, class alloc> class std::__cxx11::list'
    6 |      template<class elem, class alloc> class list;
      |                                              ^~~~
In file included from /opt/rh/devtoolset-11/root/usr/include/c++/11/list:63,
                 from test.cpp:1:
/opt/rh/devtoolset-11/root/usr/include/c++/11/bits/stl_list.h:556:11: note:                 'template<class _Tp, class _Alloc> class std::list'
  556 |     class list : protected _List_base<_Tp, _Alloc>
      |           ^~~~
test.cpp:13:19: error: expected primary-expression before 'int'
   13 |         std::list<int> l;
      |                   ^~~

问题原因 #

Devtoolset是Red Hat为旧版RHEL/CentOS提供的兼容工具链，为了适配CentOS 7的低版本glibc，其GCC对C++11 ABI的实现逻辑与原生GCC存在差异：

• 在devtoolset环境中，_GLIBCXX_USE_CXX11_ABI默认被定义为1，但标准库同时在std全局命名空间和std::__cxx11内联命名空间中保留了list模板的定义；
• 代码中手动在std::__cxx11内声明了list模板，而内联命名空间的特性会将其中的符号注入到父命名空间std中，导致编译器同时识别到两个同名模板（用户声明的std::__cxx11::list和标准库的std::list），引发引用歧义；
• AlmaLinux 9的原生GCC 11中，std::list仅通过std::__cxx11内联命名空间暴露，全局std下的list是该版本的别名，因此用户声明的模板不会与标准库版本产生冲突。

解决方案 #

方案1：禁用C++11 ABI（推荐） #

编译时添加以下编译器选项：

-D_GLIBCXX_USE_CXX11_ABI=0

该选项会强制devtoolset使用旧版C++ ABI，此时_GLIBCXX_USE_CXX11_ABI未被定义，代码中手动声明list的分支不会生效，从而避免歧义。

方案2：临时适配模板参数名 #

在使用std::list时，显式使用与标准库一致的模板参数名（_Tp和_Alloc），例如：

std::list<_Tp=int, _Alloc=std::allocator<int>> l;

此方法依赖标准库内部命名，不具备可移植性，仅作为临时 workaround 使用。

方案3：修改devtoolset标准库头文件（不推荐） #

修改devtoolset的/opt/rh/devtoolset-11/root/usr/include/c++/11/list头文件，确保std::list仅通过内联命名空间暴露。此方法涉及修改系统文件，可能破坏其他程序编译，需谨慎操作。

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