Go代理模式通过组合+接口嵌入+显式委托实现，而非继承；需定义小而专注的接口（如FileReader），真实对象与代理对象均实现该接口，代理通过显式字段持有真实对象并手动委托调用。
Go 语言本身没有类和继承，所以代理模式不是靠“继承接口+重写方法”来实现的，而是通过组合 + 接口嵌入 + 显式委托完成的。它更轻量、更符合 Go 的设计哲学。
用 interface 定义被代理行为
代理模式的前提是存在一个清晰的行为契约。在 Go 中，这必须是一个 interface。比如一个文件读取服务：
type FileReader interface {
Read(filename string) ([]byte, error)
}
注意：不要定义成具体结构体方法集，否则无法被不同实现（真实对象 / 代理）统一接受。
- 所有代理和真实对象都必须实现这个
FileReader - 接口越小越好，避免把日志、缓存、鉴权等非核心职责塞进来
- 如果已有旧代码用结构体指针做参数，需先抽离为接口，否则无法注入代理
实现真实对象与代理对象并组合
真实对象专注业务逻辑；代理对象持有真实对象，并在其方法前后插入横切逻辑：
立即学习“go语言免费学习笔记（深入）”；
type RealFileReader struct{}
func (r *RealFileReader) Read(filename string) ([]byte, error) {
return os.ReadFile(filename)
}
type LoggingFileReader struct {
reader FileReader // 组合，不是继承
}
func (l *LoggingFileReader) Read(filename string) ([]byte, error) {
fmt.Printf("Reading file: %s\n", filename)
data, err := l.reader.Read(filename)
if err != nil {
fmt.Printf("Read failed: %v\n", err)
}
return data, err
}
关键点：
《PHP设计模式指南》中文版
下载
《PHP设计模式》首先介绍了设计模式，讲述了设计模式的使用及重要性，并且详细说明了应用设计模式的场合。接下来，本书通过代码示例介绍了许多设计模式。最后，本书通过全面深入的案例分析说明了如何使用设计模式来计划新的应用程序，如何采用PHP语言编写这些模式，以及如何使用书中介绍的设计模式修正和重构已有的代码块。作者采用专业的、便于使用的格式来介绍相关的概念，自学成才的编程人员与经过更多正规培训的编程人员
-
LoggingFileReader不嵌入FileReader，而是显式声明字段 + 显式调用l.reader.Read() - 代理对象可嵌套：比如
LoggingFileReader{reader: &CachingFileReader{reader: &RealFileReader{}}} - 避免循环依赖：代理和真实对象不能互相 import；通常把
interface放在独立包（如contract或port）
代理常用于控制访问或增强能力
Go 中典型的代理用途不是为了“替类挡访问”，而是为了无侵入地叠加能力：
-
缓存代理：检查
map[string][]byte是否命中，未命中再调reader.Read()并写入缓存 -
限流代理：用
golang.org/x/time/rate.Limiter在Read()前limiter.Wait() -
鉴权代理：检查
filename是否在白名单中，否则返回os.ErrPermission - 重试代理：对临时错误（如网络 IO timeout）自动重试 2–3 次
这些都不需要修改 RealFileReader，只需新写一个结构体 + 实现同一接口 + 组合原对象。
小心隐式接口满足带来的误代理
Go 的接口是隐式实现的，容易“不小心”满足了某个接口而被当成代理目标：
- 比如你定义了
type Closer interface{ Close() error }，而*os.File恰好有Close()方法 —— 它就自动实现了Closer - 若你写了
type TracingCloser struct{ io.Closer }，它会直接嵌入并转发Close()，但没加 trace 日志，等于白写 - 务必确认代理对象是否真的做了增强逻辑，而不是仅靠匿名字段“自动代理”
真正可控的代理，永远始于显式字段 + 显式方法实现，而不是匿名嵌入。
