2. 接口声明：接口类型的语法、方法集的定义、命名规范与最佳实践

接口声明是 Go 语言中定义行为契约的核心手段。一个接口类型通过一组方法签名来约定实现者必须提供的行为。本章将系统讲解接口声明的完整语法、方法集的定义规则、命名惯例以及业界最佳实践，帮助你写出清晰、可复用且符合 Go 哲学的接口。

2.1 接口类型的基本语法

Go 的接口类型使用 type 关键字声明，后跟接口名称和 interface{} 关键字块。块内列出所有需要实现的方法签名（方法名、参数列表、返回值列表）。

// 基本接口声明格式
type 接口名称 interface {
    方法名1(参数列表) 返回值列表
    方法名2(参数列表) (返回值1, 返回值2)
    // ...
}

示例：定义一个文件读取器接口

package storage

// Reader 定义数据读取契约
type Reader interface {
    Read(p []byte) (n int, err error)
    Close() error
}

2.2 方法集的定义规则

接口的方法集（Method Set）决定了哪些类型可以满足该接口。Go 的方法集规则与值接收者和指针接收者密切相关，这是接口契约实现中的核心约束。

2.2.1 方法集与接收者类型

type Stringer interface {
    String() string
}

type User struct {
    Name string
}

// 值接收者实现
func (u User) String() string {
    return u.Name
}

// 指针接收者实现
func (u *User) UpdateName(name string) {
    u.Name = name
}

// 接口赋值规则
var s Stringer
u := User{Name: "Alice"}
s = u       // ✅ 值接收者，User 和 *User 都满足
s = &u      // ✅ 同样满足

type Updater interface {
    UpdateName(name string)
}

var upd Updater
upd = &u    // ✅ 指针接收者，只有 *User 满足
// upd = u  // ❌ 编译错误：User 未实现 Updater

2.3 命名规范与最佳实践

Go 社区在接口命名上形成了高度一致的风格，遵循这些规范能让你的接口契约一目了然。

2.3.1 核心命名惯例

2.3.2 接口大小设计原则

• 小接口优先： 尽量保持接口只包含 1~3 个方法。Go 标准库中的 io.Reader（1 个方法）、io.Writer（1 个方法）是典范。
• 接口组合优于继承： 使用接口嵌套组合构建复杂行为，而非定义大而全的接口。
• 只声明调用方需要的方法： 接口是消费方视角的契约，不要为实现方提供额外方法。

// ✅ 推荐：小接口 + 组合
type Reader interface {
    Read(p []byte) (n int, err error)
}

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

type ReadWriter interface {
    Reader
    Writer
}

// ❌ 不推荐：大而全的接口
type FileIO interface {
    Read(p []byte) (n int, err error)
    Write(p []byte) (n int, err error)
    Close() error
    Seek(offset int64, whence int) (int64, error)
    Truncate(size int64) error
    Sync() error
}

2.4 接口声明结构图

下图展示了接口声明的完整结构、方法集规则以及命名规范之间的关系：

2.5 接口声明实战示例

以下是一个完整的接口声明示例，综合运用了本章的所有规则：

package cache

import "time"

// Item 表示缓存中的单个条目（包内结构体）
type Item struct {
    Key       string
    Value     interface{}
    ExpiresAt time.Time
}

// Storer 定义缓存存储契约（单方法接口，-er 结尾）
type Storer interface {
    Store(key string, value interface{}, ttl time.Duration) error
}

// Loader 定义缓存加载契约（单方法接口）
type Loader interface {
    Load(key string) (interface{}, bool)
}

// Cache 组合存储与加载能力（多方法接口，名词短语）
type Cache interface {
    Storer
    Loader
    Delete(key string) error
    Clear() error
}

// 包内接口：仅限内部使用的验证器
type validator interface {
    Validate(key string, value interface{}) error
}

2.6 常见声明错误与避坑