接口即契约：Go 接口的设计哲学

在 Go 语言中，接口（interface）不是一种“继承”或“类型层次”工具，而是一份行为契约。接口定义了类型必须提供的方法集合，但不关心该类型内部如何实现。这种设计哲学让接口成为模块之间最自然的抽象边界，也是依赖注入得以在 Go 中优雅落地的核心基石。

接口作为抽象边界

接口将“做什么”与“怎么做”彻底分离。在 Web 架构中，接口通常位于模块的边界处：调用方只依赖接口，实现方只满足接口。双方通过接口契约进行协作，彼此无需了解内部细节。

小接口优于大接口

Go 社区推崇“小接口”设计——接口只包含 1~3 个方法。小接口具有以下优势：

接口的隐式实现与显式声明

Go 接口采用隐式实现（structural typing）：只要一个类型实现了接口中的所有方法，它就自动满足该接口，无需显式声明 implements 关键字。这是 Go 区别于 Java、C# 等语言的关键设计决策。

隐式实现的优势

• 松耦合：实现方不需要导入接口所在的包，只需方法签名匹配即可。
• 易于测试：可以轻松创建 mock 或 stub 实现，无需修改生产代码。
• 适配器模式自然：任何类型只要方法匹配，就可以作为接口的实例使用。

显式声明的辅助手段

虽然 Go 不需要显式声明，但有时为了编译期检查或文档目的，可以使用空赋值来“断言”类型实现了接口：

// 编译期检查：确保 *MySQLUserRepo 实现了 UserRepo 接口
var _ UserRepo = (*MySQLUserRepo)(nil)

这种写法不会产生运行时开销，但会在编译时报告类型是否满足接口，是一种推荐的防御性编程习惯。

接口设计实战原则

1. 定义在消费侧：接口放在使用它的包中，而不是实现它的包中。这避免了循环依赖，也保持了实现方的独立性。
2. 只定义你需要的方法：不要为了“未来可能用到”而添加方法。接口应该恰好满足当前调用方的需求。
3. 使用接口组合：通过组合小接口构建复杂接口，而不是一次性定义大接口。

// 小接口组合示例
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
}

接口在依赖注入中的角色

在依赖注入场景中，接口是连接“注入器”和“消费者”的桥梁。注入器负责将具体的实现注入到接口变量中，消费者只通过接口调用方法，完全不知道具体实现的存在。