functional options 是 go 处理复杂配置的首选方案，适用于字段超3个、含默认值或需扩展的场景；构造函数须用变参 opts...option 并遍历执行；字段需预初始化防 panic；option 应无副作用且校验前置。
Functional Options 是 Go 里处理复杂配置最稳妥的通用解法，不是“可选”，而是“该用就用”——尤其当结构体字段超过 3 个、存在默认值、或未来可能扩展时。
构造函数签名写错：NewClient(WithTimeout(5), WithRetries(3)) 编译失败
这是最常遇到的编译错误，根本原因是构造函数只接收单个 Option，而不是变参切片。
- 错误写法：
func NewClient(opt Option) *Client→ 传两个函数值直接类型不匹配 - 正确写法：
func NewClient(opts ...Option) *Client→...表示可变参数，Go 自动打包成[]Option - 内部必须遍历：
for _, opt := range opts { opt(c) }，漏掉循环只会执行第一个选项 - 别在构造函数里做
opts[0](c)这种硬索引，既不安全也不符合模式语义
WithXXX 函数修改了 nil map 或 slice 导致 panic
字段初始化没做全，Option 函数里又没判空，一调就崩。这不是逻辑错，是内存模型没对齐。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
headers字段是map[string]string？构造时就得c.headers = make(map[string]string) -
middleware是[]Middleware？得初始化为c.middleware = []Middleware{}，不能留nil - 在
WithHeaders里直接写c.headers["X-Trace"] = "on"前，必须确认c.headers != nil - 追加中间件要用
c.middleware = append(c.middleware, m)，不是c.middleware = m（后者会覆盖）
Option 函数里混入副作用，对象变得不可预测
Functional Options 的语义是“声明配置”，不是“触发动作”。一旦引入 IO、goroutine 或全局状态，测试、重载、并发都会出问题。
- 禁止在
WithTLSConfig里调ioutil.ReadFile或os.Open - 禁止在
WithContext里起 goroutine 监听ctx.Done() - 禁止在
WithLogger里调log.SetOutput修改全局 logger - 所有副作用（如证书加载、连接池初始化、协程启动）应延迟到
Client.Start()或首次Do()时执行
校验逻辑放错位置：d ≤ 0 该在哪拦？
零值语义模糊（比如 Timeout=0 到底是“禁用超时”还是“未设置”）必须靠设计规避，而不是靠运行时猜。
- 校验必须放在
WithTimeout函数体内，而不是构造函数末尾 —— 否则用户传WithTimeout(-1)就直接生效了 - 典型写法：
if d 或返回 <code>error（若用func(*Client) error签名） - 如果选项之间有依赖（如
WithInsecureSkipVerify必须配合WithTLSConfig），检测也得放在对应WithXXX里，或统一收口在构造函数 apply 完后 - 别指望调用方传参顺序合理；他们可能从 YAML 动态解析选项列表，顺序不可控
真正难的不是写出第一个 WithTimeout，而是确保每个 WithXXX 都不偷偷改别的字段、不分配不该分配的资源、不假设调用时机——这些细节不显眼，但线上故障往往就卡在这儿。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
