Go函数不支持可选参数，需用指针显式表达“未设置”状态，但必须配合取地址调用和nil检查；多参数宜用结构体指针，语义不清时改用自定义类型或选项函数。
Go 函数没法直接定义可选参数，指针不是“语法糖”而是显式契约
Go 没有默认参数、重载或命名参数，func f(name string, age *int) 中的 *int 不是“让 age 可选”的魔法开关，而是明确告诉调用方：“你得自己决定传不传，且必须传一个地址——哪怕是个零值地址”。这带来两个关键约束：调用方必须显式取地址（&age），且函数内部必须做 nil 检查。漏掉任一环节，要么编译报错，要么运行 panic。
常见错误现象：cannot use age (type int) as type *int in argument to f；或函数里直接解引用 *age 导致 panic: runtime error: invalid memory address or nil pointer dereference。
- 使用场景：配置初始化（如
http.Client构造）、数据库查询选项（Limit,Offset）、日志上下文字段注入 - 参数差异：基础类型（
*string,*bool）比结构体指针更轻量，但结构体指针更适合多字段组合（如*Options） - 性能影响：指针传递本身开销极小，但需注意：如果函数内频繁解引用 + 判空，逻辑会变啰嗦；大量零值指针也可能增加 GC 压力（不过通常可忽略）
用结构体指针替代多个独立指针参数更清晰也更安全
当可选参数超过 2–3 个，别写 func f(a *string, b *int, c *bool, d *time.Duration)。这种签名难读、难调、难维护。结构体指针把语义聚拢，调用时还能用字面量初始化，天然支持“部分字段赋值”。
示例：type Config struct { Timeout *time.Duration; Retries *int; Debug *bool }，调用 f(&Config{Timeout: &d}) 就只设超时，其余字段自动为 nil。
立即学习“go语言免费学习笔记（深入）”；
- 容易踩的坑：结构体字段没加
json:"..."标签导致序列化失败；字段名首字母小写导致外部包无法访问 - 兼容性影响：结构体新增字段是向后兼容的（旧代码不传新字段，值为
nil），但删字段或改类型会破坏 ABI - 不要在结构体里混用值类型和指针类型字段（如
Timeout time.Duration和Retries *int），语义不一致，判空逻辑分裂
零值有意义时，别用指针，改用自定义类型或哨兵值
如果某个参数的“未设置”和“设为零”含义不同（比如 timeout=0 表示“不超时”，而“未设置 timeout”表示“用默认值”），那 *time.Duration 就不合适——因为 new(time.Duration) 得到的是 &0，你无法区分“用户传了 0”和“用户根本没传”。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
这时该用自定义类型 + 显式状态标记：
type Timeout struct {
Duration time.Duration
Set bool
}或更简洁的哨兵值（如 const NoTimeout = -1 * time.Second），函数内判断 if timeout == NoTimeout。
- 常见错误：把
time.Duration(0)当作“未设置”标志，结果用户真想设 0 秒时逻辑被绕过 - 性能/可读性：自定义类型略增一点内存（多一个
bool字段），但换来的是语义绝对清晰，调试时一眼看出字段是否被显式设置
接口参数 + 选项函数（Option Pattern）比裸指针更灵活，但别过早抽象
当可选参数逻辑复杂、需要校验、或未来可能扩展行为（比如“设置超时”同时要“注册监控指标”），裸指针就力不从心了。此时用函数类型封装选项：type Option func(*Config)，再提供 WithTimeout(d time.Duration) 这样的构造函数。
示例调用：NewClient(WithTimeout(30*time.Second), WithRetries(3))。
- 容易踩的坑：选项函数内部修改了共享的
*Config，但没做深拷贝，导致多个 client 实例互相污染 - 性能影响：每次调用都会分配闭包，高频创建对象时会有额外 GC 压力；简单场景下纯属杀鸡用牛刀
- 兼容性：新加一个
WithXXX()不影响旧调用，但老代码若用了未导出字段直改，升级后可能失效
真正难的不是选哪种方式，而是判断“这个参数到底有没有‘未设置’这一状态”。没想清楚这点，指针、结构体、选项函数全都会用错。
