functional options是go解决可选参数爆炸的唯一合理路径：option必须为func(t)，构造函数需用func newclient(opts ...option) client并遍历执行，默认值初始化须在apply前完成，withxxx仅做字段赋值，禁止副作用。
Functional Options 不是语法糖，它是 Go 里解决“可选参数爆炸”的唯一合理路径。 其他方式要么语义模糊（结构体传参分不清 0 是用户设的还是没设），要么维护成本高（Builder 模式要写一堆类型和方法），要么破坏兼容性（加个参数就全量重编译）。
为什么 NewClient(WithTimeout(5), WithRetries(3)) 会编译失败
常见错误是把构造函数签名写成 func NewClient(opt Option) *Client，只收一个 Option 值。Go 不支持自动展开多个函数参数为切片——它不会把 WithTimeout(5), WithRetries(3) 自动打包成 []Option。调用时类型不匹配，直接报错。
正确签名必须是变参形式：func NewClient(opts ...Option) *Client。注意末尾的 ...，这是关键。
- 内部必须用
for _, opt := range opts遍历执行，不能只写if len(opts) > 0 { opts[0](c) }—— 否则第二个选项静默丢弃 - 如果误用
func NewClient(opts Option)却想传多个，编译器提示类似cannot use WithTimeout(5) (value of type Option) as type Option in argument to NewClient，本质是类型不匹配，不是语法错
Option 类型必须是 func(*T)，不能是值传递
定义成 type Option func(T) 或 func(Config) Config 看似能跑，但所有字段修改都发生在副本上，最终对象仍是默认值。调试时你会发现 WithTimeout 像没起作用，但又没报错，极难定位。
真正生效的前提只有一个：Option 函数体内操作的是原始内存地址。
- 构造函数里初始化结构体后，必须传指针给每个
opt(c)，比如c := &Client{}，而不是c := Client{} - 所有
WithXXX工厂函数返回的匿名函数，参数必须是*Client，否则闭包改的是局部副本 - 一旦用了值传递，测试里断言字段值永远过不了——因为你在测副本，不是真实实例
默认值初始化必须在 apply options 之前，且字段要“真初始化”
默认值不是兜底逻辑，而是配置起点。顺序错了，用户明确传的配置会被覆盖回去。
典型翻车代码：c := &Client{}; opt(c); c.timeout = 30 * time.Second。哪怕用户调了 WithTimeout(10 * time.Second)，最终 timeout 还是 30 秒。
- 所有字段（包括
map、slice、chan、指针）必须在c := &Client{}这一步完成合理初始化，例如headers: make(map[string]string)、middleware: []Middleware{}、logger: log.New(os.Stderr, "", 0) - 若字段是
*log.Logger且未初始化，后续WithLogger赋值没问题；但若字段是log.Logger（值类型）且零值，WithLogger只能改副本，无效 - 结构体里含
sync.Mutex等非零值类型时，不能依赖字面量初始化（sync.Mutex{}合法但不推荐），应显式调用var mu sync.Mutex再赋值
哪些操作绝对不能放进 WithXXX 函数体
WithXXX 的语义是“声明配置”，不是“执行初始化”。混入副作用会让对象不可预测，尤其在测试或热重载场景下直接崩。
- 启动 goroutine（如
WithContext(ctx)里监听ctx.Done()）→ 应延迟到Start()或首次Do() - 阻塞 IO（如
WithCertPath(path)里直接ioutil.ReadFile）→ 改为传路径，读取延后 - 打开网络连接（如
WithAddr(addr)里调net.Dial）→ 连接动作不属于配置阶段 - 修改全局状态（如
WithLogger(l)里调log.SetOutput）→ logger 实例应只用于本对象，不污染全局 - 深拷贝或大内存分配（如接收
*tls.Config却不做clone）→ 外部后续修改会意外影响本实例
真正容易被忽略的是：**WithXXX 函数里连日志打印都算副作用**——它可能触发输出、格式化、锁竞争，破坏纯配置语义。配置阶段只该做字段赋值与简单校验。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
