Go中WithXxx函数必须接收指针参数，因需原地修改结构体字段；传值会导致赋值作用于副本，构造函数仍获零值；必须用*Client才能穿透闭包影响原始对象。
Go 里 WithXxx 函数为什么必须接收指针参数
因为选项函数要原地修改目标结构体字段，而不是返回新实例。如果传值（func(c Client)），所有赋值都发生在副本上，构造函数拿到的仍是初始零值。常见错误是写成 return func(c Client) { c.timeout = t }，结果 NewClient(WithTimeout(5)) 完全没生效。
必须用 *Client：只有指针能穿透闭包影响原始对象。顺便提醒，别在闭包里捕获大对象（比如整个 *http.Client），容易引发隐性内存泄漏。
- 字段赋值必须直接、无条件——校验逻辑不该塞进
WithXxx，那是Validate()或构造函数里该干的事 - 不要返回新结构体，否则就不是 functional options，而是普通工厂函数
- 如果结构体嵌套深（如
c.HTTP.Security.Enabled），WithSecurityEnabled仍应接收*Client，内部解引用赋值即可
多个 WithXxx 调用顺序是否影响结果
会影响，而且很实在：后调用的选项会覆盖同字段的前值。比如 WithTimeout(10 * time.Second), WithTimeout(2 * time.Second)，最终生效的是 2 秒。
这不是 bug，是模式的设计前提——它允许用户“覆盖默认配置”。但容易踩坑的地方在于：
立即学习“go语言免费学习笔记（深入）”；
- 同一字段被多个 option 修改时，行为取决于调用顺序，没有编译期提示
- 带副作用的 option（如注册回调、启动 goroutine）顺序错可能导致重复初始化或竞态
- 别指望靠命名约定（如
WithPreInitTLS）来管理顺序，实际维护成本高，也不可靠
稳妥做法是：一个字段只由一个语义明确的 WithXxx 负责，避免重叠职责。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
Option 类型该定义成 func(*T) 还是 func(*T) error
优先用 func(*T) error。虽然基础写法常省略 error，但生产代码里，提前拦截非法配置比运行时报 panic 强得多。
比如 WithTimeout(-1 * time.Second)，在 WithTimeout 内部立刻 return errors.New("timeout must be positive")，比等到第一次 HTTP 请求时才炸好太多。
- 构造函数里必须检查每个
opt(c)的返回值：if err := opt(c); err != nil { return nil, err } - 不要用
panic做校验——这会让调用方无法 recover，也违背 option 的“可组合”本意 - error 是 option 合法性边界，不是运行时异常；没 error 就代表这个配置项已安全就绪
必选参数和 WithXxx 怎么共存才不混乱
把真正不可缺的参数放在构造函数签名最前面，只把可选、有默认值的配置放进 WithXxx。例如 NewClient(addr string, opts ...ClientOption)，addr 漏传编译直接报错，而 WithTimeout 漏传就走默认值。
常见反模式是把所有东西都塞进 option，比如连地址也写成 WithAddress("api.example.com")，结果调用时少传一个，程序跑起来才 panic。
- 必选参数 ≠ 非空字段：有些字段业务上必须设（如 API 密钥），但类型上可以是空字符串，这时得在
Validate()阶段显式检查 - 别依赖
nil判断是否设置——WithLogger(nil)可能是用户有意禁用日志，不是漏填 - 如果某组字段强耦合（如
MinIdle/MaxIdle），考虑合并为单个WithConnectionPool(min, max)，别拆两个 option
最易被忽略的一点：字段级 option 看似灵活，但泛化过度（比如 WithField("timeout", "5s")）会彻底丢失类型安全和 IDE 支持，不如老老实实写 WithTimeout。
