4、接口设计原则：小接口原则、单一职责原则在接口中的应用、接口的命名规范与惯例

接口是 Go 语言中实现抽象与多态的核心机制，其设计质量直接决定了代码的可扩展性、可测试性与可维护性。本章聚焦三大核心设计原则：小接口原则、单一职责原则在接口中的应用以及接口的命名规范与惯例。掌握这些原则，能够帮助你在项目结构中构建出高内聚、低耦合的接口契约。

4.1 小接口原则（The Small Interface Principle）

Go 语言推崇“接口越小越好”。一个接口应当只包含一个或极少数紧密相关的方法，而不是将多个功能塞进同一个接口中。小接口的优势在于：

• 组合灵活：多个小接口可以按需组合成更大的接口，实现“按需接入”。
• 实现门槛低：任何类型只需实现少量方法即可满足接口契约，降低了适配成本。
• 隐式解耦：小接口天然减少了依赖方与被依赖方之间的耦合度。

4.1.1 小接口 vs 大接口对比

4.1.2 小接口设计示例

以下代码展示了一个“大接口”如何被拆解为多个小接口，并通过组合实现灵活复用：

// 反模式：大接口
type FileService interface {
    Read(path string) ([]byte, error)
    Write(path string, data []byte) error
    Delete(path string) error
    List(dir string) ([]string, error)
    Copy(src, dst string) error
    Move(src, dst string) error
}

// 推荐：拆解为小接口
type Reader interface {
    Read(path string) ([]byte, error)
}

type Writer interface {
    Write(path string, data []byte) error
}

type Deleter interface {
    Delete(path string) error
}

type Lister interface {
    List(dir string) ([]string, error)
}

// 按需组合
type ReadWriter interface {
    Reader
    Writer
}

type FileManager interface {
    Reader
    Writer
    Deleter
    Lister
}

4.2 单一职责原则在接口中的应用

单一职责原则（SRP）要求一个接口只负责一个明确的抽象维度，即“一个接口只做一件事”。这与小接口原则相辅相成，但更强调接口的语义内聚性：接口中的方法必须属于同一个职责范畴。

4.2.1 职责划分的判定标准

判断一个接口是否违反 SRP，可以从以下三个角度分析：

1. 变化原因：如果接口中的方法因为不同的业务需求而频繁变化，说明它们属于不同职责。
2. 调用者视角：如果调用者通常只使用接口中的部分方法，说明接口职责过重。
3. 实现者负担：如果实现一个接口需要同时处理多个不相关的逻辑，说明接口需要拆分。

4.2.2 SRP 接口拆分案例

以下是一个典型的违反 SRP 的接口及其重构方案：

// 违反 SRP：一个接口同时负责数据持久化、日志记录和通知发送
type UserService interface {
    CreateUser(user User) error
    GetUser(id int) (*User, error)
    LogAction(action string) error
    SendWelcomeEmail(email string) error
}

// 符合 SRP：拆分为三个职责清晰的接口
type UserRepository interface {
    Create(user User) error
    Get(id int) (*User, error)
}

type Logger interface {
    Log(action string) error
}

type Notifier interface {
    SendWelcome(email string) error
}

// 业务组合层按需注入
type UserUseCase struct {
    repo     UserRepository
    logger   Logger
    notifier Notifier
}

4.3 接口的命名规范与惯例

Go 社区形成了约定俗成的接口命名规则，遵循这些规则能让代码更具可读性和一致性。

4.3.1 核心命名规则

4.3.2 常见接口命名模式

• 行为型命名：强调接口能做什么，如 io.Reader、sort.Interface。
• 角色型命名：强调接口在系统中扮演的角色，如 http.Handler、database/sql.Driver。
• 能力型命名：强调接口提供的能力集合，如 sync.Locker、context.Context。

4.3.3 命名反模式

4.4 接口设计原则综合图示

下图展示了小接口原则、单一职责原则与命名规范在接口设计中的协同关系：

4.5 接口设计检查清单

在实际编码中，可以使用以下清单快速评估接口设计质量：