在 Go 中定义/实现接口、设计抽象或可 mock 边界时…

当需要定义或实现 Go 接口、设计抽象、为测试创建可 mock 边界、通过嵌入组合类型，或决定接受接口还是返回具体类型、使用类型断言/类型切换时使用。

适用场景

解决思路

1. 接口应定义在消费值的包中，而不是实现它的包中；构造函数返回具体类型（通常是指针或结构体），以便后续新增方法时无需重构。
2. 不要在接口被使用之前就定义它：没有真实的使用示例，很难判断接口是否必要。
3. 如果某个类型存在的唯一目的就是实现一个接口、且没有该接口之外的导出方法，则从构造函数返回该接口以隐藏实现（如 func NewHash() hash.Hash32 { return &myHash{} }），这样实现可替换、算法切换只需改构造函数调用。
4. 类型断言必须使用 comma-ok 惯用法避免 panic：str, ok := value.(string); if ok { ... }；检查是否实现某接口：if _, ok := val.(json.Marshaler); ok { ... }。
5. 类型切换中惯用复用变量名（t := t.(type)），每个 case 分支中变量具有正确类型；当 case 列出多个类型（如 case int, int64:）时，变量为接口类型。
6. 避免在公开结构体中嵌入类型——内部类型的完整方法集会成为你公开 API 的一部分；改用未导出字段。
7. 用空白标识符赋值在编译期验证类型实现了接口：var _ json.Marshaler = (*RawMessage)(nil)，若不满足会编译报错。
8. 仅在以下情况添加接口满足性检查：没有静态转换会自动验证接口、类型必须满足接口才能正确行为（如自定义 JSON 序列化）、接口变更应导致编译失败而非静默降级；不要为每个接口都加这种检查。
9. 定义接口或实现后，运行 bash scripts/check-interface-compliance.sh 验证所有具体类型都有编译期 var _ I = (*T)(nil) 检查。
10. 接收者类型拿不准时用指针接收者；不要在同一类型上混用接收者类型——只要有一个方法需要指针，所有方法都用指针；仅对小型不可变类型（Point、time.Time）或基本类型使用值接收者。
11. 嵌入接口时用 type RW interface { Reader; Writer } 取方法并集；嵌入结构体时用 type S struct { *T } 提升 T 的方法。
12. 命名接口时参考 go-naming 的 -er 后缀约定与接收者命名；实现 error 接口、自定义错误类型或 errors.As 匹配时参考 go-error-handling；判断该用泛型还是接口时参考 go-generics；使用基于接口的 Option 模式时参考 go-functional-options；做更广泛的 API 边界加固时参考 go-defensive。

适用边界 · 注意事项

• 不适用于基于泛型的多态（应改用 go-generics）。
• 不要为每个接口都添加 var _ I = (*T)(nil) 编译期检查，仅在没有其他静态转换能捕获错误时才加。
• 不要在公开结构体中嵌入类型，以免内部类型方法集泄漏为公开 API。