Golang设计模式：使用函数式选项（Functional Options）安全初始化复杂结构体-Golang-PHP中文网

newclient(withtimeout(5), withretries(3))编译失败是因为构造函数签名写成func newclient(opt option) client，只接收单个option，无法匹配两个参数；正确应为func newclient(opts ...option) client，并用for _, opt := range opts遍历执行。

golang设计模式：使用函数式选项（functional options）安全初始化复杂结构体

为什么 NewClient(WithTimeout(5), WithRetries(3)) 会编译失败

因为构造函数签名写成了 func NewClient(opt Option) *Client，只接收单个 Option，而 Go 不支持自动展开变参。调用时传两个函数值，类型不匹配直接报错。

正确做法是让构造函数接收变参切片：

func NewClient(opts ...Option) *Client —— 这样 WithTimeout(5), WithRetries(3) 才能被收进 []Option
内部必须用 for _, opt := range opts 遍历，不能只调一次 opt(c)
如果还用了 ...Option 但函数体里漏了循环，那只有第一个选项生效，其余静默丢弃

默认值初始化为什么必须在 apply options 之前

默认值不是“后备兜底”，而是配置的起点。如果先 apply 选项、再设默认值，等于把用户明确传入的配置又覆盖回去了。

典型翻车场景：

用户调用 NewClient(WithTimeout(10*time.Second))，但构造函数里写成：c := &Client{}; opt(c); c.timeout = 30 * time.Second → 最终 timeout 是 30 秒，不是 10 秒
结构体字段为指针或 map 时，零值是 nil，若未在初始化阶段 make(map[string]string) 或 &log.Logger{}，后续 WithHeaders 或 WithLogger 可能 panic
所有字段（包括切片）都该在 c := &Client{...} 这一步完成合理初始化，比如 middleware: []Middleware{}

WithXXX 函数里哪些操作算副作用，必须避免

functional options 的语义是“声明配置”，不是“执行初始化”。一旦引入副作用，对象就不再可预测，尤其在测试或配置热重载时会出问题。

以下行为必须从 WithXXX 中剥离：

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

启动 goroutine（如在 WithContext 里起一个监听 cancel 的协程）
阻塞 IO（如 WithCertPath 里直接 ioutil.ReadFile）
打开网络连接（如 WithAddr 里调 net.Dial）
修改全局状态（如 WithLogger 里调 log.SetOutput）
分配大内存或深拷贝（如传入 *tls.Config 却不做 clone，导致外部修改影响实例）

这些动作该延迟到 Client.Start()、Server.Listen() 或首次 Do() 时做。

Option 类型该用 func(T) 还是 func(T) error

取决于这个配置项是否可能“合法失败”。不是所有选项都需要 error，混用反而增加复杂度。

推荐统一用 func(*T) error，哪怕当前没校验逻辑——留好扩展位，后续加校验不用改签名：

WithBaseURL(u string)：解析失败应返回 url.Error
WithTLSConfig(cfg *tls.Config)：检查 cfg != nil，否则返回 errors.New("tls config is nil")
WithTimeout(d time.Duration)：若要求正数，if d 0") }
但 WithDebug(b bool) 或 WithRetries(n int) 纯赋值，可不校验，返回 nil 即可