Clang编译C++20代码时链接器报容器模板实例未定义引用

问题现象 #

用GCC 11编译C++20代码完全正常，但切换到Clang 14（包括15、16、17版本）编译后，链接器会报所有容器类模板实例的未定义引用错误，典型示例如Widget<std::vector<bool>>::doSth()。

临时解决方案 #

• 给Widget类的doSth成员函数添加__attribute__((used))属性，强制编译器保留该符号不被优化；
• 将invoke调用中的lambda表达式替换为具名可调用结构体，避免lambda带来的隐式符号处理差异。

问题根源推测 #

这个问题本质是GCC与Clang在模板实例化的符号保留策略上的实现差异：

• Clang在处理lambda捕获结合模板隐式实例化的场景时，可能误判符号未被实际使用，从而在优化阶段将其剔除，导致链接时找不到对应定义；
• std::vector<bool>是标准库中的特化模板，内存布局和常规std::vector不同，这种特殊性可能触发Clang的特殊优化逻辑，进一步导致符号被错误丢弃；
• 添加__attribute__((used))直接干预了编译器的符号保留逻辑，而改用可调用结构体则绕过了lambda的隐式符号生成机制，从而规避了问题。

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