如何以兼容迁移的方式为C++类添加新的纯虚方法？

架构老林

2026-7-5

兼容迁移方案：向现有抽象类添加新纯虚方法

问题背景

我们维护一个C++库L，其中的抽象类X包含多个纯虚方法。生产环境中，用户直接使用库提供的X派生类，无需自行实现；但在单元测试场景下，用户会从X派生类来编写模拟对象。现在需要给X新增一个纯虚方法：

针对你提到的“先设为非纯虚但无法提示用户适配”的问题，可以通过以下方式解决：

第一步：添加带默认实现的非纯虚方法，并标记弃用默认行为
将新方法设为非纯虚，提供一个默认实现，同时用编译器特性（如[[deprecated]]）标记这个默认实现为弃用，强制用户在自己的模拟类中重写该方法：
```
class X {
public:
    // 原有纯虚方法
    virtual void old_method() = 0;
    
    // 新增方法：非纯虚，默认实现标记弃用
    [[deprecated("请在派生类中重写此方法，下一版本将改为纯虚")]]
    virtual void new_method() {
        // 空实现或抛出异常（提醒用户未重写）
        throw std::logic_error("new_method 未被重写");
    }
};
```
这样：
- 用户的现有模拟类能正常实例化（源代码兼容）
- 如果用户未重写new_method，编译时会收到弃用警告，运行时若调用该方法会抛出异常（倒逼用户适配）
第二步：转为纯虚方法
等待足够版本周期后，将new_method改为纯虚，移除默认实现和弃用标记：
```
class X {
public:
    virtual void old_method() = 0;
    virtual void new_method() = 0; // 转为纯虚
};
```

在库中提供一个专门用于测试的基类，帮用户屏蔽接口变更的影响：

第一步：新增测试基类XTestBase
从X派生，为所有纯虚方法（包括新增的）提供默认实现，供用户的模拟类继承：
```
// 仅在测试头文件中提供
class XTestBase : public X {
public:
    // 原有方法的默认实现
    void old_method() override {}
    
    // 新增方法的默认实现
    void new_method() override {}
};
```
同时在文档中引导用户：单元测试的模拟类请继承XTestBase而非直接继承X。
第二步：逐步推进纯虚变更
后续版本中，直接将X的new_method改为纯虚，用户的模拟类因为继承自XTestBase，无需修改即可正常工作。

如果希望完全隔离新旧接口的影响，可以采用接口拆分的方式：

第一步：新增抽象类XWithNewMethod
从X派生，添加新的纯虚方法：
```
class XWithNewMethod : public X {
public:
    virtual void new_method() = 0;
};
```
库中的生产派生类可以逐步改为继承XWithNewMethod，并实现new_method；而用户的现有模拟类仍继承X，不受影响。
第二步：合并接口（可选）
当所有用户都完成适配后，将new_method移回X并改为纯虚，同时废弃XWithNewMethod。

如果希望直接在X类中完成迁移，方案1是最直接的选择——通过带弃用提示的默认实现，既保证现有代码兼容，又能有效提醒用户适配；如果想彻底简化用户测试代码的维护，方案2的测试基类模式能长期降低用户的适配成本。

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