Go 无原生装饰器语法，需用高阶函数、接口嵌入等显式方式实现；函数级装饰用泛型化包装，方法级装饰靠接口+组合，须规避闭包捕获、生命周期及类型安全陷阱。
Go 语言没有原生的 decorator（装饰器）语法，像 Python 的 @decorator 那样直接修饰函数或方法。这不是遗漏，而是设计取舍：Go 倾向显式、可追踪的控制流。想实现类似效果，必须靠组合、高阶函数和接口——而且得小心绕过常见误解。
为什么不能直接写 @log 或 @trace
Go 的语法层不支持注解式装饰；func 不是一等公民意义上的“可装饰对象”（它不可被元数据标记或运行时重绑定）。所有看似“装饰”的行为，本质是手动替换函数值、包装方法接收者，或用接口抽象行为。
- 试图用 struct tag 模拟装饰器（如
//go:generate+ 代码生成）可行，但属于编译期静态方案，无法动态增删逻辑 - 反射能读取 tag，但不能在运行时“给已有函数加装饰”，只能用于构造新函数
- 直接修改标准库或用户函数签名来“注入”装饰逻辑，会破坏类型安全与调用契约
用高阶函数实现函数级装饰（最常用）
把装饰逻辑封装为接受 func() 并返回 func() 的函数，是最自然、零依赖的做法。适用于纯函数、HTTP handler、定时任务等场景。
例如日志装饰：
立即学习“go语言免费学习笔记（深入）”；
func withLog(f func()) func() {
return func() {
log.Println("before")
f()
log.Println("after")
}
}
// 使用：
handler := withLog(func() {
fmt.Println("do work")
})
handler() // 输出日志 + do work
- 注意参数传递：若原函数带参数（如
func(int, string)），装饰器也需对应泛型化或用interface{}+ 类型断言（不推荐） - 更实用的方式是限定装饰目标为 HTTP handler：
func(http.Handler) http.Handler，这样可直接链式调用withAuth(withLog(myHandler)) - 不要在装饰器里 recover panic 并吞掉——除非你明确知道该错误应静默处理，否则会掩盖真实问题
用嵌入+接口实现方法级装饰（适合结构体方法）
当需要装饰某个 struct 的多个方法（比如给 *DB 加统一超时或重试），别试图“装饰方法”，而是让原始类型实现接口，再用包装类型组合并重写部分方法。
示例：
type Store interface {
Get(key string) (string, error)
Set(key, val string) error
}
type LoggingStore struct {
Store // 嵌入
}
func (l *LoggingStore) Get(key string) (string, error) {
log.Printf("Get start: %s", key)
defer log.Printf("Get done: %s", key)
return l.Store.Get(key)
}
- 嵌入不是继承，
LoggingStore必须持有Store实例（如&LoggingStore{Store: realDB}），否则调用l.Store.Get会 panic - 如果原始类型方法有指针接收者，包装类型也必须用指针接收者，否则接口实现不成立
- 这种模式天然支持多层装饰（如
&TimeoutStore{&LoggingStore{realDB}}），但要注意错误传播是否被意外截断
容易被忽略的陷阱：闭包变量捕获和生命周期
装饰器返回的闭包常会捕获外部变量，若这些变量是局部临时对象（如循环变量、短生命周期 struct 字段），极易引发意料外的共享或提前释放。
- 在 for 循环中批量创建装饰函数时，别直接捕获循环变量
i或v，要用显式副本：for i, v := range xs { go func(idx int, val string) { ... }(i, v) } - 装饰器若保存了对
context.Context的引用，要确认其生命周期是否长于被装饰函数执行时间；否则可能触发context canceled错误 - HTTP handler 装饰器中，不要把
http.ResponseWriter存到全局或长期缓存里——它是一次性对象，且可能被 hijack 或 flush
真正难的不是写出一个能跑的装饰器，而是判断某段逻辑到底该塞进装饰器、中间件、还是直接写进业务函数里。边界模糊时，优先选显式调用——哪怕多写一行 logBefore(); f(); logAfter()，也好过让团队成员花十分钟看懂你写的五层嵌套包装类型。
