接口组合时方法签名冲突会直接编译失败；go要求同名方法签名（参数类型、数量、顺序及返回值）必须完全一致，否则报duplicate method错误，解决方式为统一签名、重命名或拆分组合层级。
接口组合时方法签名冲突会直接编译失败
接口组合不是简单拼接，而是把嵌入接口的所有方法签名合并到新接口里。只要两个被嵌入的接口里有同名方法，哪怕参数或返回值稍有不同，Go 编译器就会报错，比如：duplicate method String 或 conflicting implementations of String。
常见场景是多个子接口都定义了 String() 或 MarshalJSON()，而你试图用一个顶层接口统一它们。这时不能靠“覆盖”或“优先级”绕过，必须手动解耦：
- 重命名其中一个方法（如
ToString()/ToJSON()），避免名字重复 - 拆分组合层级，让冲突方法不在同一嵌入链上
- 放弃组合，改用函数参数传多个独立接口（如
func render(s Stringer, j JSONer)）
嵌入结构体字段 ≠ 实现接口，方法集才是关键
很多人误以为 type A struct { *B } 就自动实现了 B 所满足的接口，但实际取决于调用方用的是 A 还是 *A —— 因为方法集只包含接收者类型匹配的方法。
例如：若 B 有 func (b *B) Do() {}，那么只有 *A 能调用 Do()；A 值本身无法满足该接口。错误现象常表现为：cannot use a (type A) as type Interface in assignment。
- 检查接口要求的方法接收者是值还是指针：用
go doc查看方法签名 - 确保嵌入字段的类型与接口方法接收者一致（
*B对应*B方法，B对应B方法） - 必要时在包装类型上显式补全缺失方法（哪怕只是转发）
空接口 interface{} 不等于万能适配器，类型断言仍需谨慎
interface{} 确实能接收任意类型，但它不提供任何行为契约。一旦需要调用具体方法（比如 .Len() 或 .Close()），就必须做类型断言或类型切换，而这正是运行时 panic 的高发区。
典型错误是写成：v.(io.Closer).Close()，却没检查断言是否成功，结果遇到非 io.Closer 类型就崩溃。
- 永远用双赋值形式判断：
if c, ok := v.(io.Closer); ok { c.Close() } - 避免在热路径频繁断言；可提前转成具体接口变量缓存
- 如果逻辑依赖多个行为，优先定义组合接口（如
type ReadCloser interface { io.Reader; io.Closer }），而非层层断言
多态不是靠“猜类型”，而是靠接口契约驱动流程
Go 的多态本质不是运行时识别类型再分支处理，而是把行为抽象成接口，让调用方只依赖接口方法，实现方各自提供逻辑。最易被忽略的一点是：**接口方法的设计粒度决定扩展成本**。
比如定义 type Processor interface { Process() error } 看似通用，但当某类处理器还需支持回滚、超时、重试时，就得不断往接口加方法，破坏已有实现。正确做法是按场景拆分小接口，再组合使用：
type Runnable interface { Run() error }type Rollbackable interface { Rollback() error }type Timeoutable interface { WithTimeout(time.Duration) Runnable }
这样新增能力只需实现对应小接口，老代码不受影响。真正难的不是写接口，而是预判哪些行为会随业务演进而分化——这需要对领域模型有足够理解，而不是堆砌“通用性”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
