选项模式是Go中控制初始化复杂度的刚需方案，通过函数类型Option（func(*Client)）组合配置，确保默认值→选项应用→校验的顺序，避免参数失控、零值歧义与校验分散。
Go 里没有构造函数重载，也没有默认参数，直接传一堆参数的函数或结构体初始化极易失控——选项模式不是“高级技巧”，而是控制初始化复杂度的刚需方案。
为什么
很危险
这种签名看似清晰，实则脆弱：
参数顺序不能错，加个新配置就得改所有调用点，还可能漏掉中间某个可选参数
调用方无法直观看出哪些是必填、哪些是可选；
或
常被误用作“未设置”，但它们本身可能是合法值（比如重试 0 次 = 禁用重试）
无法对参数做预校验（例如
应该立刻报错，而不是等到第一次 HTTP 请求才 panic）
选项模式把“配置行为”从参数列表里抽出来，变成可组合、可复用、可验证的函数。
类型必须是函数类型，且接收指针
典型定义是：
。关键点在于：
立即学习
“
go语言免费学习笔记（深入）
”；
函数签名必须接受
（或目标结构体指针），这样才能在内部修改字段
返回值必须为空（
），否则无法链式调用
不能用接口（如
），那样会强制用户实现方法、增加样板代码，也失去函数字面量的简洁性
示例：
初始化函数里必须先设默认值，再逐个应用
顺序很重要：默认值 → 用户选项 → 校验。不能边应用边校验，否则默认值可能被覆盖后才校验，导致逻辑错乱。
所有字段应在创建结构体时赋予合理默认值（比如
），而非留空或零值
必须在默认值之后、校验之前执行
校验逻辑（如
）要放在最后，确保看到的是最终状态
常见错误是把校验写在某个
内部——这会让校验分散、不可控，且无法感知多个选项叠加后的非法状态（比如同时设置了
和
）。
嵌套结构或第三方依赖字段要小心零值覆盖
如果
包含一个
字段，而你提供
，注意：
不要在默认值里 new 一个
后又允许用户传入另一个——这会造成资源泄漏风险（旧 client 的 transport 可能还在跑请求）
更安全的做法是：默认值用
，在最终校验阶段检查是否为
，若是则赋默认实例；这样用户传入非 nil 才真正生效
对
这类字段，也要避免直接赋
默认值，因为它的零值本身是合法的；应明确区分“未设置”和“显式设为空配置”
本质问题是：Go 没有“可空引用”的语法标记，得靠设计约定（比如“nil 表示未设置，非 nil 表示用户指定”）来维持语义清晰。
选项模式真正难的不是写几个函数，而是想清楚哪些该进选项、哪些该进结构体字段、哪些必须校验、哪些允许覆盖——边界模糊时，宁可多拆一个选项函数，也不要在一个选项里塞条件分支逻辑。
func NewClient(addr string, timeout time.Duration, retries int, tlsConfig *tls.Config)0niltimeout <= 0Optiontype Option func(*Client)*Clientfunc(*Client)NewClient(WithTimeout(5*time.Second), WithTLS(...))type Option interface{ Apply(*Client) }type Client struct {
addr string
timeout time.Duration
retries int
tlsCfg *tls.Config
}
type Option func(*Client)
func WithTimeout(d time.Duration) Option {
return func(c *Client) {
c.timeout = d
}
}
func WithRetries(n int) Option {
return func(c *Client) {
c.retries = n
}
}
Optiontimeout: 30 * time.Secondfor _, opt := range opts { opt(c) }if c.timeout <= 0OptionWithRetries(0)WithRetryBackoff(nil)Clienthttp.ClientWithHTTPClient(&http.Client{...})*http.Clientnilnil*tls.Config&tls.Config{}