Go接口仅含方法签名，无字段或实现；类型自动满足所有方法签名一致的接口；接口值为(type, value)对，nil接口不等于nil具体值。
Go 接口定义必须是方法签名集合，不能含字段或实现
Go 的 interface 本质是一组方法签名的契约，不是类型模板或抽象类。它不允任何字段、构造函数、默认方法实现，也不支持继承（嵌入是组合，不是继承）。
常见错误是试图在接口里写 var Name string 或 func Print() { ... } —— 这会直接报错：invalid interface field name 或 interface method must have no body。
- 接口定义只允许形如
Read(p []byte) (n int, err error)的方法签名 - 方法名首字母大小写决定是否导出：小写方法无法被包外实现类型满足
- 空接口
interface{}是所有类型的子集，但没方法，仅用于泛型前的过渡场景
类型自动满足接口，无需显式声明“implements”
Go 没有 implements 关键字。只要某个类型实现了接口中**所有方法**（签名完全一致：名称、参数类型、返回类型），它就自动满足该接口 —— 无论是否在同一包、是否提前知晓该接口存在。
这叫“结构化类型系统”，和 Java/C# 的“名义类型”完全不同。典型误用是给结构体加 // implements Reader 注释，其实毫无作用；更危险的是以为“没写就等于不满足”，结果运行时才暴露类型断言失败。
立即学习“go语言免费学习笔记（深入）”；
- 方法接收者类型必须匹配：指针接收者方法只能由
*T实现，值接收者方法T和*T都能调用（但T不能满足要求指针接收者的接口） - 参数/返回类型必须严格一致，
[]int和MyIntSlice（即使底层相同）不兼容 - 接口变量赋值时若类型不满足，编译期直接报错：
cannot use xxx (type Y) as type Z in assignment
接口值底层是 (type, value) 对，nil 接口 ≠ nil 具体值
一个接口变量实际存储两个东西：动态类型（concrete type）和动态值（concrete value）。当接口变量为 nil，只表示这两个字段都为空；但一个非 nil 接口变量，其内部具体值仍可能是 nil（比如 *os.File 为 nil）。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
这导致常见坑：对接口做 == nil 判断，可能掩盖真实问题。例如函数返回 io.Reader，你检查 r == nil 通过了，但实际 r 是 *bytes.Buffer 类型、内部 buf 字段为 nil，后续 Read 就 panic。
- 判断接口是否真正可用，应结合具体类型做类型断言后检查，如
if b, ok := r.(*bytes.Buffer); ok && b != nil { ... } - 函数参数用接口类型时，避免传入
nil值；必要时文档明确“不接受 nil”并早期 panic - 接口变量打印出来是
<nil></nil>或，不是具体类型的字符串表示
接口组合与嵌入要小心方法冲突和语义漂移
用 type ReadWriter interface { Reader; Writer } 是合法的接口嵌入，等价于把 Reader 和 Writer 所有方法平铺进来。但嵌入不是继承，不会带来任何实现，只是语法糖。
真正容易出问题的是多个接口嵌入后出现同名方法但签名不同（比如一个接口有 Close() error，另一个有 Close() bool）—— 这会导致组合接口无法被任何类型实现，编译失败：duplicate method Close。
- 嵌入接口时，确保它们的方法集无冲突；如有重名，必须手动重写整个方法集来消歧
- 不要为“看起来像”而强行组合：比如把
fmt.Stringer和json.Marshaler组合成新接口，除非业务上真需要两者同时满足 - 接口命名优先用单个能力动词（
Reader,Writer），避免宽泛名词（DataHandler），否则实现成本高、复用性差
type Speaker interface {
Speak() string
}
<p>type Dog struct {
Name string
}</p><p>func (d Dog) Speak() string { // 值接收者
return "Woof! I'm " + d.Name
}</p><p>func main() {
var s Speaker = Dog{Name: "Buddy"} // OK：Dog 满足 Speaker
fmt.Println(s.Speak()) // "Woof! I'm Buddy"</p><pre class='brush:php;toolbar:false;'>var s2 Speaker = &Dog{Name: "Max"} // 也 OK：*Dog 同样满足（值接收者方法可被指针调用）
fmt.Println(s2.Speak()) // "Woof! I'm Max"}
接口的轻量和隐式满足是 Go 的优势，也是陷阱来源。最常被忽略的，是接收者类型和接口值底层结构这两点 —— 它们不报错在定义时，而藏在运行时行为和跨包协作的缝隙里。
