go选项模式的核心是函数值，即用func(*t)类型函数作为配置载体，通过闭包修改目标实例，避免结构体嵌套与副作用，构造时统一apply且顺序决定覆盖关系。
Go 选项模式的核心是函数值，不是结构体嵌套
选项模式在 Go 里本质是用 func(*T) 类型的函数作为配置载体，而不是靠定义一堆中间结构体或接口。它解决的是构造函数参数爆炸、可选字段多、默认值难维护的问题。关键在于：每个选项是一个闭包，能自由访问外部变量，且执行时机可控——只在构建对象时统一 apply。
- 错误做法：把选项定义成带字段的 struct，再写一堆
NewOptionX()返回 struct 实例 —— 这失去了函数式灵活性，也容易误传未初始化字段 - 正确姿势：定义类型
type Option func(*Client)，每个选项函数直接修改目标实例 - 典型陷阱：选项函数里启动 goroutine 或做阻塞 IO（比如在
WithTimeout里调http.DefaultClient.Do）—— 构造阶段不该有副作用
如何安全地组合多个 Option 并控制执行顺序
Go 没有内置选项组合语法，必须手动设计接收变参的构造函数。顺序很重要：后 applied 的选项会覆盖先 applied 的同字段设置（比如两个 WithTimeout，后者生效）。
- 构造函数签名应为
func NewClient(opts ...Option) *Client，内部用循环依次调用opt(c) - 避免在选项函数里做深拷贝或资源预分配（如提前 dial TCP 连接），这些该延迟到
Client.Do()阶段 - 如果某个选项依赖其他选项已设置的字段（比如
WithBaseURL必须早于WithPath），文档要明确，但代码不强制校验——Go 倾向信任调用方
示例：
type Client struct { baseURL string; timeout time.Duration }
type Option func(*Client)
func WithBaseURL(u string) Option { return func(c *Client) { c.baseURL = u } }
func WithTimeout(d time.Duration) Option { return func(c *Client) { c.timeout = d } }
func NewClient(opts ...Option) *Client {
c := &Client{timeout: 30 * time.Second}
for _, opt := range opts { opt(c) }
return c
}
什么时候不该用 functional options
不是所有场景都适合。当配置项极少（
- 简单函数：直接用具名参数更清晰，比如
OpenFile(name string, flag int, perm FileMode) - 配置强绑定：用结构体 + 构造验证，比如
tls.Config本身已是结构体，再套一层 options 易引发歧义 - 性能敏感路径：每次 new 一个函数值有微小开销（闭包分配），高频创建对象时需权衡；但绝大多数业务代码无感
常见错误：nil 选项函数 panic 和并发不安全
如果用户传了 nil 进 opts ...Option，循环里直接调用会 panic。另外，多个 goroutine 同时对同一 *Client 调用不同选项函数（虽然少见）会导致数据竞争。
- 防御写法：在构造函数里加
if opt != nil { opt(c) }判断 - 并发场景：选项函数只应在构造阶段使用；若需运行时动态重配，应另提供线程安全方法（如
SetTimeout加 mutex） - 典型报错：
panic: runtime error: invalid memory address or nil pointer dereference—— 往往是忘了判空或误把 struct 当函数传了
真正麻烦的是跨包传递选项时的隐式依赖：A 包定义了 WithLogger，B 包用了它，但 B 的测试没 mock logger，导致测试环境 panic。这种耦合不会在编译时报错，得靠约定和文档兜底。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
