functional options 是 go 中初始化含默认值、可选字段、需扩展结构体的唯一推荐方式；必须用 func(*t) error 定义 option，构造函数接收变参 opts ...option 并遍历执行，且默认值初始化须在遍历前完成。
直接说结论：Functional Options 不是“高级技巧”，而是 Go 里初始化含默认值、可选字段、未来需扩展的结构体时，唯一值得长期投入的构造方式；用 func(*T) error 定义 Option 类型，构造函数接收变参 opts Option 并遍历执行，且默认值必须在遍历前完成初始化——这四点没做到，基本等于白写。
为什么 NewClient(WithTimeout(5), WithRetries(3)) 编译失败
因为构造函数签名写成了 func NewClient(opt Option) *Client，只收一个 Option 值，而 Go 不会自动把两个函数参数展开成切片。调用时传两个函数值，类型不匹配，编译器直接报错。
- 正确签名必须是
func NewClient(opts ...Option) *Client（注意...）或func NewClient(opts Option) *Client（Go 1.23+ 支持变参切片语法，但语义等价） - 内部必须用
for _, opt := range opts遍历，不能只调一次opt(c) - 如果漏写循环，只有第一个选项生效，其余静默丢弃，极难排查
Option 类型该用 func(*T) 还是 func(*T) error
取决于这个配置项是否可能“合法失败”。不是所有选项都需要 error，但混用两种类型会让构造函数逻辑分裂、调用方困惑。
- 推荐统一用
func(*T) error：哪怕当前没校验逻辑，也留好扩展位（比如后续加证书路径检查） -
WithTimeout(t time.Duration)、WithDebug(b bool)这类纯赋值操作，用func(*T)更轻量，但需确保团队共识一致 - 一旦用了
error版本，构造函数里必须检查：if err := opt(c); err != nil { return nil, err }，忽略 error 是线上静默故障常见源头
结构体字段为指针或 map 时，为什么一调 WithHeaders 就 panic
因为 c := &Client{} 初始化时没做合理预分配，字段零值是 nil，后续 WithHeaders 直接对 nil map 赋值触发 panic。
- 所有字段（包括切片、map、指针）都应在构造函数开头完成初始化：
headers: make(map[string]string)、middleware: []Middleware{}、logger: log.Default() -
WithHeaders函数里应只做c.headers[k] = v或for k, v := range h { c.headers[k] = v }，不负责 make - 若字段是
*log.Logger，初始化时写logger: log.New(os.Stderr, "", 0)，而非nil，避免后续判空逻辑分散
为什么 WithXXX 函数里绝对不能启动 goroutine 或读文件
Functional Options 的语义是“声明配置”，不是“执行初始化”。副作用会破坏构造时机可控性，尤其在测试、热重载、并发创建时出问题。
- 禁止行为包括：
go listenCancel(ctx)、ioutil.ReadFile(certPath)、net.Dial(addr)、log.SetOutput(...) - 这些动作必须延迟到
Client.Start()、Server.Listen()或首次Do()时才执行 - 闭包里别捕获大对象（如整个
*http.Client），防止外部修改意外影响已创建实例
最易被忽略的其实是顺序：默认值初始化必须在 for _, opt := range opts 之前完成，否则用户传的 WithTimeout 可能被后面硬编码的赋值覆盖；还有就是 map 和切片字段的初始化，不写 make 或 []T{}，panic 发生时根本看不出是哪一行惹的祸。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
