Go语言常见接口设计技巧-《Go语言实战指南》

在 Go 中，接口是连接代码组件的桥梁。合理设计接口可以大幅提升程序的可维护性、可扩展性和测试友好性。本章将分享 Go 开发中常见的接口设计技巧与最佳实践。

---

一、接口设计原则

1. 面向接口编程，而非面向实现编程

尽量使用接口类型作为函数参数或返回值，从而实现模块解耦。

func SaveData(store DataStore, data string) {
    store.Save(data)
}

---

2. 接口只依赖需要的方法（接口隔离原则）

尽量定义最小化接口，避免臃肿。

推荐：

type Reader interface {
    Read(p []byte) (n int, err error)
}

❌ 不推荐：

type ReadWriteCloser interface {
    Read(p []byte) (n int, err error)
    Write(p []byte) (n int, err error)
    Close() error
}

如果调用者只需要 Read()，就没必要依赖多余方法。

---

二、常用技巧与模式

技巧1：定义行为接口而非数据接口

接口应关注行为，不应暴露内部结构。

type Logger interface {
    Log(message string)
}

而不是：

type Logger struct {
    FilePath string
    Format   string
}

---

技巧2：优先返回接口而不是结构体

隐藏实现细节，便于后续扩展与替换。

func NewStorage() Storage {
    return &fileStorage{}
}

---

技巧3：为最小接口命名以“-er”结尾

Go 的命名惯例：

• • Reader
• • Writer
• • Closer
• • Formatter

即表示“拥有某种能力”。

---

技巧4：使用接口组合实现可插拔架构

type Cache interface {
    Getter
    Setter
}

type Getter interface {
    Get(key string) (string, error)
}

type Setter interface {
    Set(key, value string) error
}

不同的模块可实现不同组合能力，提升灵活性。

---

技巧5：使用接口简化单元测试（Mock接口）

通过接口依赖注入，可轻松替换为 mock 对象：

type DB interface {
    Query(sql string) ([]Row, error)
}

// 测试时使用 fakeDB
type fakeDB struct{}
func (f fakeDB) Query(sql string) ([]Row, error) {
    return []Row{{"mock"}}, nil
}

---

技巧6：避免导出只被一个包使用的接口

反面示例：

// 在 package db 中定义
type Queryer interface {
    Query(sql string) ([]Row, error)
}

如果这个接口仅用于本包内部，不如直接使用具体类型。

---

三、小结

技巧	说明
定义行为接口	接口表示能力，不暴露数据
最小接口原则	每个接口只定义一类职责
接口组合	将多个小接口组合成大接口，提高可配置性
接口名以 “-er” 结尾	遵循 Go 命名习惯，易读易懂
接口用于解耦和测试	替换真实依赖，方便单元测试

---