Go 接口基础回顾：接口定义、隐式实现、空接口、类型断言

在深入业务模块边界设计之前，必须夯实 Go 接口的核心基础。Go 的接口系统是静态类型语言中最灵活、最简洁的契约机制之一。本章将系统回顾接口的定义语法、隐式实现机制、空接口的用途以及类型断言的正确用法，为后续的模块边界契约设计打下坚实的地基。

1. 接口定义：契约的声明

Go 中的接口是一组方法签名的集合，它定义了一个类型应当具备的行为规范，而不关心具体的数据结构。接口定义使用 type 关键字，后跟接口名称和 interface 关键字。

// 定义一个业务模块的存储接口
type UserRepository interface {
    FindByID(id uint) (*User, error)
    Save(user *User) error
    Delete(id uint) error
}

// 定义一个支付网关接口
type PaymentGateway interface {
    Charge(amount float64, currency string) (string, error)
    Refund(transactionID string) error
}

2. 隐式实现：Go 的独特契约机制

Go 是唯一一个采用隐式实现的主流静态类型语言。一个类型只要实现了接口中的所有方法，就自动满足该接口，无需显式声明 implements 关键字。这种设计极大地降低了类型之间的耦合度。

// 定义接口
type Notifier interface {
    Send(to string, message string) error
}

// 定义具体类型 - 无需声明 implements
type EmailNotifier struct {
    SMTPHost string
    SMTPPort int
}

// 隐式实现了 Notifier 接口
func (e *EmailNotifier) Send(to string, message string) error {
    // 发送邮件的具体逻辑
    return nil
}

// 另一个类型也隐式实现了 Notifier
type SMSNotifier struct {
    APIKey string
}

func (s *SMSNotifier) Send(to string, message string) error {
    // 发送短信的具体逻辑
    return nil
}

// 使用接口作为参数 - 多态
func SendAlert(n Notifier, userEmail string) {
    n.Send(userEmail, "系统告警：服务异常")
}

3. 空接口：通用容器与类型擦除

空接口 interface{} 不包含任何方法，因此所有类型都隐式实现了空接口。在 Go 1.18 之后，空接口有了别名 any，两者完全等价。

// 空接口可以存储任意类型的值
var data interface{}
data = 42
data = "hello"
data = struct{ Name string }{"Alice"}

// 使用 any 别名（Go 1.18+）
var payload any
payload = []int{1, 2, 3}

// 空接口作为函数参数 - 可以接收任意类型
func PrintValue(v any) {
    fmt.Printf("值: %v, 类型: %T\n", v, v)
}

4. 类型断言：从接口中提取具体类型

类型断言用于从接口值中提取其底层的具体类型。Go 提供了两种形式：安全断言（带 ok 判断）和非安全断言（直接提取，可能 panic）。

// 安全断言 - 推荐使用
var val any = "hello, world"

if str, ok := val.(string); ok {
    fmt.Println("字符串长度:", len(str))
} else {
    fmt.Println("类型不匹配")
}

// 非安全断言 - 谨慎使用
// str := val.(string)  // 如果 val 不是 string，会 panic

// 类型 switch - 处理多种类型
func DescribeType(v any) {
    switch t := v.(type) {
    case string:
        fmt.Printf("字符串: %q\n", t)
    case int:
        fmt.Printf("整数: %d\n", t)
    case bool:
        fmt.Printf("布尔: %v\n", t)
    case nil:
        fmt.Println("空值")
    default:
        fmt.Printf("未知类型: %T\n", t)
    }
}

5. 接口值的内部结构

理解接口值的底层结构对于正确使用接口至关重要。Go 中的接口值由两部分组成：类型指针（指向具体类型的元数据）和数据指针（指向具体值的副本或原值）。

6. 接口比较与 nil 陷阱

接口值的比较和 nil 判断是 Go 开发中最常见的陷阱之一。由于接口值包含类型信息，一个接口变量即使底层数据为 nil，只要类型指针不为 nil，它就不等于 nil。

// 经典 nil 陷阱
var p *int = nil
var i any = p

fmt.Println(p == nil)  // true
fmt.Println(i == nil)  // false！因为 i 的类型信息不为 nil

// 正确的 nil 判断方式
func IsNil(v any) bool {
    if v == nil {
        return true
    }
    // 通过反射判断底层值是否为 nil
    reflectVal := reflect.ValueOf(v)
    switch reflectVal.Kind() {
    case reflect.Ptr, reflect.Map, reflect.Slice, reflect.Chan, reflect.Func:
        return reflectVal.IsNil()
    }
    return false
}

7. 接口在模块边界中的角色

在 DDD 架构中，接口扮演着模块边界契约的角色。以下是接口在不同层级中的典型应用：

8. 本章小结