1. 接口契约概述

什么是接口契约

接口契约（Interface Contract）是软件设计中一种行为约定：它规定了“调用方可以做什么”以及“实现方必须提供什么”，但不涉及具体如何实现。在 Go 语言中，接口契约由一组方法签名组成，任何类型只要实现了这些方法，就自动满足该契约。

为什么需要接口契约

没有接口契约的代码往往陷入紧耦合的泥潭：高层模块直接依赖底层实现，修改一处牵动全身。接口契约从以下四个维度解决这一痛点：

1. 解耦依赖：调用方只依赖抽象接口，不依赖具体类型，实现方可以独立替换。
2. 可测试性：通过 mock 实现接口契约，单元测试无需启动真实依赖（如数据库、网络）。
3. 扩展开放：新增功能只需提供新的接口实现，无需修改已有调用代码（开闭原则）。
4. 编译期检查：Go 编译器在编译时验证类型是否满足接口，提前捕获不匹配错误。

接口契约在 Go 中的角色

Go 的接口机制在语言层面扮演了多重角色，它不仅是抽象工具，更是架构设计的核心支柱：

• 抽象层：接口作为业务逻辑与基础设施之间的薄层，隔离变化。
• 组合单元：Go 推崇小接口（1~3 个方法），通过组合构建复杂行为。
• 测试替身：接口让 mock/stub/fake 成为可能，支撑 TDD 和 BDD 实践。
• 版本演进：接口契约定义了稳定的 API 边界，允许内部实现独立迭代。

接口契约的 Go 代码示例

以下代码展示了接口契约在 Go 中的典型用法：

// 定义接口契约
type Storage interface {
    Save(key string, value []byte) error
    Load(key string) ([]byte, error)
    Delete(key string) error
}

// 实现方 1：内存存储
type MemoryStorage struct {
    data map[string][]byte
}

func (m *MemoryStorage) Save(key string, value []byte) error {
    m.data[key] = value
    return nil
}

func (m *MemoryStorage) Load(key string) ([]byte, error) {
    val, ok := m.data[key]
    if !ok {
        return nil, fmt.Errorf("key not found: %s", key)
    }
    return val, nil
}

func (m *MemoryStorage) Delete(key string) error {
    delete(m.data, key)
    return nil
}

// 实现方 2：文件存储（仅示意）
type FileStorage struct {
    basePath string
}

func (f *FileStorage) Save(key string, value []byte) error {
    return os.WriteFile(filepath.Join(f.basePath, key), value, 0644)
}

func (f *FileStorage) Load(key string) ([]byte, error) {
    return os.ReadFile(filepath.Join(f.basePath, key))
}

func (f *FileStorage) Delete(key string) error {
    return os.Remove(filepath.Join(f.basePath, key))
}

// 调用方：只依赖 Storage 接口
type Service struct {
    store Storage
}

func (s *Service) Process(id string, data []byte) error {
    return s.store.Save(id, data)
}