3. Go 接口基础：接口定义、接口实现、空接口、类型断言

在《报表环境回放Go接口契约》课程中，接口是定义行为契约的核心机制。Go 的接口类型是一组方法签名的集合，它规定了实现者必须提供哪些行为。本章将深入讲解接口的定义、隐式实现、空接口的灵活运用以及类型断言的正确姿势。

3.1 接口定义：契约的声明

接口通过 type 关键字定义，内部包含一组方法签名。任何类型只要实现了这些方法，就自动满足该接口契约。

// 定义报表回放器的行为契约
type Replayer interface {
    Start() error
    Stop() error
    Status() (string, error)
    Replay(recordID string) error
}

3.2 接口实现：隐式满足，无需显式声明

Go 采用隐式实现（Duck Typing）机制：一个类型只要实现了接口中的所有方法，就自动实现了该接口，无需使用 implements 关键字。这种设计让代码更加灵活，解耦更彻底。

// 文件回放器：实现了 Replayer 接口
type FileReplayer struct {
    filePath string
    status   string
}

func (f *FileReplayer) Start() error {
    f.status = "running"
    return nil
}

func (f *FileReplayer) Stop() error {
    f.status = "stopped"
    return nil
}

func (f *FileReplayer) Status() (string, error) {
    return f.status, nil
}

func (f *FileReplayer) Replay(recordID string) error {
    // 从文件读取记录并回放
    return nil
}

// 使用：FileReplayer 自动满足 Replayer 接口
var r Replayer = &FileReplayer{filePath: "/data/replay.log"}

3.3 空接口：任意类型的容器

空接口 interface{} 不包含任何方法签名，因此所有类型都实现了空接口。在 Go 1.18 之后，可以使用 any 作为 interface{} 的别名。

// 空接口可以存储任意类型的值
var data any

data = 42
data = "报表回放记录"
data = []string{"record1", "record2"}
data = map[string]int{"success": 100, "failed": 2}

// 报表回放中，空接口常用于处理不确定类型的配置项
type ReplayConfig struct {
    Name    string
    Options map[string]any  // 扩展配置，值类型不确定
}

3.4 类型断言：还原具体类型

类型断言用于从接口值中提取其底层的具体值。语法为 value.(Type)，返回两个值：提取后的具体值和是否成功的布尔标志。

// 基本语法
var i any = "报表回放记录"

// 安全断言：推荐使用
if s, ok := i.(string); ok {
    fmt.Println("字符串长度:", len(s))
} else {
    fmt.Println("类型不匹配")
}

// 直接断言：不推荐，失败会 panic
s := i.(string)  // 如果 i 不是 string 类型，会触发 panic

类型断言在报表回放中的应用

// 处理不同类型的回放结果
func handleReplayResult(result any) {
    switch v := result.(type) {
    case string:
        fmt.Println("回放结果(字符串):", v)
    case int:
        fmt.Println("回放结果(状态码):", v)
    case error:
        fmt.Println("回放结果(错误):", v.Error())
    case *ReplaySummary:
        fmt.Printf("回放摘要: 成功=%d, 失败=%d\n", v.Success, v.Failed)
    default:
        fmt.Printf("未知结果类型: %T\n", v)
    }
}

3.5 接口与类型断言的关系图

下图展示了接口值在内存中的结构以及类型断言的工作流程：

3.6 接口实现与空接口对比