go语言无可选参数语法，需用*string明确区分“未提供”与“零值”，多参数用结构体，复杂配置用函数式选项，关键在语义清晰而非语法模拟。
go 语言没有可选参数语法，但能通过指针、结构体或函数式选项安全表达“未提供”语义——关键不是模拟语法，而是明确区分“未设置”和“设为零值”。
为什么 nil 不能直接传给 string 参数
Go 的类型系统里，nil 只对指针、切片、map、channel、func 和接口类型合法。string 是值类型，零值是 ""，不是 nil。所以 func f(s string) 调用时写 f(nil) 会编译报错：cannot convert nil to type string。
常见错误现象：
- 误以为
""就等于“没传”，结果 API 游标本身允许为空字符串，导致逻辑歧义 - 把
*string当成“可选语法糖”，却在函数内直接解引用*s而不检查s != nil，运行 panic
用 *string 显式表达“未提供”
指针类型让调用方能用 nil 表示“这个参数我根本不想设”，比空字符串更精确。
实操建议：
- 函数签名定义为
func getChallenges(after *string) error - 内部必须先判空：
if after != nil && *after != ""，再用*after - 调用时：传
nil表示不指定；传&cursor表示指定（注意取地址） - 可封装辅助函数简化调用：
func StringPtr(s string) *string { return &s }，但别滥用——不是所有地方都需要这种封装
多个可选参数优先用结构体 + 指针字段
当参数超过两个（比如 limit、sort、includeDeleted），别堆一堆 *int、*bool 参数。结构体能把语义聚拢，也天然支持部分赋值。
实操建议：
- 定义结构体时，所有可选字段都用指针：
type ListOptions struct { Limit *int; Sort *string; IncludeDeleted *bool } - 调用时用字面量初始化：
ListOptions{Limit: &max}，其余字段自动为nil - 字段名首字母大写，否则外部包无法访问；如果要 JSON 序列化，记得加
json:"limit,omitempty"标签 - 避免混用值类型和指针类型字段（如
Timeout time.Duration和Retries *int），否则判空逻辑分裂，维护成本陡增
复杂配置场景用函数式选项（Functional Options）
当构造逻辑需要校验、副作用控制或未来扩展性强（比如 HTTP 客户端、数据库连接池），函数式选项是最健壮的选择。
实操建议：
- Option 类型定义为
type Option func(*Client) error，返回 error 才能在构造阶段拦截非法值（比如负超时） - 必选参数（如服务地址）必须放在函数签名最前面：
func NewClient(addr string, opts ...Option) (*Client, error) - 多个 Option 按顺序执行，后设覆盖先设（
WithTimeout(5)后跟WithTimeout(10)，最终是 10）——这不是 bug，是设计使然，但得在文档里写清楚 - 别在 Option 函数里做耗时操作（如读文件、发请求），构造阶段只做赋值和轻量校验
最容易被忽略的一点：没有银弹。单个可选字符串用 *string 最轻量；三四个参数用结构体最直观；组件级初始化才值得上函数式选项——选错模式比不选更伤。
