C++库类重命名：过渡期间ABI兼容及旧名弃用方案问询

要在版本1.1中既保留与1.0的ABI兼容性，又只针对旧名称Old触发弃用警告（使用New不警告），可以利用编译器的标识符级弃用指令，而非直接给类本身加[[deprecated]]属性——类级弃用会让所有指向该类的别名（包括New）都触发警告，而标识符级弃用只会针对Old这个名称生效。

具体实现步骤：

1. 保留原Old类的定义，确保ABI与1.0版本完全一致：

   class Old {};
   

2. 引入新名称New的类型别名：

   using New = Old;
   

3. 使用编译器特定的#pragma指令弃用Old标识符：

   // 兼容Clang、GCC和MSVC
   #if defined(__clang__) || defined(__GNUC__) || defined(_MSC_VER)
       #pragma deprecated(Old)
   #endif
   

效果说明：

• 用户直接使用Old时，编译器会弹出弃用警告，引导切换到New；
• 使用New时不会触发任何警告；
• 原Old类的内存布局、符号名称与1.0版本完全一致，ABI兼容性得到保障。

如果需要自定义警告信息，可针对不同编译器调整：

#if defined(__clang__) || defined(__GNUC__)
    // Clang/GCC支持自定义警告消息
    #pragma GCC deprecated(Old, "请使用New替代Old")
#elif defined(_MSC_VER)
    #pragma deprecated(Old)
#endif

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