4、接口隔离原则（ISP）：胖接口的危害，如何拆分出细粒度的测试桩接口

接口隔离原则，英文叫 Interface Segregation Principle，简称 ISP。它是 SOLID 五大原则之一。但说实话，很多嵌入式工程师对它的理解，只停留在「接口要小」这个层面。

为什么我要单独拿一章来讲 ISP？因为在我十几年的嵌入式开发生涯里，「胖接口」是导致测试难、耦合重、重构慢的头号元凶。你想想看，一个驱动接口里塞了十几个函数，你的测试桩就得实现十几个空函数。改一个接口，所有桩都得跟着改。这谁受得了？

4.1 胖接口到底有多「胖」？

先看一个我早年踩过的坑。当时做一个车载信息娱乐系统，底层有一个 Storage_Device 接口，负责管理所有存储设备。接口长这样：

// 胖接口：一个接口管所有
typedef struct {
    int32_t (*Init)(void);
    int32_t (*Read)(uint32_t addr, uint8_t* buf, uint32_t len);
    int32_t (*Write)(uint32_t addr, const uint8_t* buf, uint32_t len);
    int32_t (*Erase)(uint32_t addr, uint32_t len);
    int32_t (*Sync)(void);
    int32_t (*GetStatus)(uint32_t* status);
    int32_t (*GetCapacity)(uint64_t* capacity);
    int32_t (*Format)(void);
    int32_t (*PowerDown)(void);
    int32_t (*PowerUp)(void);
    int32_t (*SetSpeedMode)(uint8_t mode);
    int32_t (*GetErrorLog)(char* log, uint32_t* len);
} Storage_Device_t;

这个接口有 12 个函数。看起来挺全的，对吧？但问题来了——

• 上层应用只需要 Read、Write、GetCapacity。
• 文件系统层需要 Read、Write、Erase、Sync。
• 诊断模块需要 GetStatus、GetErrorLog、Format。
• 电源管理需要 PowerDown、PowerUp。

你看，没有一个客户端需要全部 12 个函数。但每个客户端都依赖了整个接口。这意味着什么？

4.2 如何拆分出细粒度的测试桩接口？

拆分的核心思路就一句话：按客户端拆分，而不是按设备拆分。每个客户端只看到它需要的接口。

拿上面的 Storage 接口举例，我把它拆成了四个小接口：

拆分之后，每个接口的函数数量从 12 个降到了 2~4 个。写测试桩的工作量直接减少了 60%~70%。

4.3 细粒度接口的测试桩实现

接口拆细了，测试桩怎么写？我直接给你看代码。假设我们要为 Storage_ReadWrite 接口写一个测试桩：

// 测试桩：只实现 ReadWrite 接口
static uint8_t mock_storage[1024];
static bool mock_initialized = false;

static int32_t Mock_Read(uint32_t addr, uint8_t* buf, uint32_t len) {
    if (!mock_initialized) return -1;
    if (addr + len > sizeof(mock_storage)) return -2;
    memcpy(buf, &mock_storage[addr], len);
    return 0;
}

static int32_t Mock_Write(uint32_t addr, const uint8_t* buf, uint32_t len) {
    if (!mock_initialized) return -1;
    if (addr + len > sizeof(mock_storage)) return -2;
    memcpy(&mock_storage[addr], buf, len);
    return 0;
}

static int32_t Mock_GetCapacity(uint64_t* capacity) {
    *capacity = sizeof(mock_storage);
    return 0;
}

// 测试桩接口实例
Storage_ReadWrite_t mock_storage_rw = {
    .Read = Mock_Read,
    .Write = Mock_Write,
    .GetCapacity = Mock_GetCapacity
};

你看，这个测试桩只实现了 3 个函数。干净、简单、容易维护。如果接口没拆分，你得额外实现 9 个空函数，而且那些空函数还得考虑返回值、状态管理，测试代码会变得又臭又长。

4.4 接口隔离与分层架构的关系

接口隔离原则和分层架构是天生一对。每一层只依赖下一层的一个小接口，而不是整个下层模块。这样，层与层之间的耦合度降到最低。

我画了一张图，帮你理解这种关系：

这张图里，每一层都只依赖一个细粒度接口。底层驱动可以独立替换，不影响上层。测试时，每一层都可以用对应的测试桩独立测试，互不干扰。

4.5 避坑指南：拆分接口时常见的三个错误

接口拆分不是拆得越细越好。我见过有人把 12 个函数的接口拆成 12 个单函数接口，结果接口数量爆炸，管理成本反而更高。这里有几个我踩过的坑：

4.6 接口隔离的测试收益量化

最后，我用一个表格来量化接口隔离带来的测试收益。这是我实际项目中的统计数据：

数据不会骗人。接口隔离不是「设计洁癖」，它是实实在在能帮你省时间、省力气的工程实践。