Go 语言推荐使用可变参数（...Option）实现灵活、可扩展的函数配置，而非为每种组合定义独立函数；该模式被标准库（如 net/http, database/sql）及主流开源项目广泛采用，兼顾向后兼容性、可读性与类型安全。
go 语言推荐使用可变参数（...option）实现灵活、可扩展的函数配置，而非为每种组合定义独立函数；该模式被标准库（如 net/http, database/sql）及主流开源项目广泛采用，兼顾向后兼容性、可读性与类型安全。
在 Go 生态中，当一个基础函数（如 Marshal）需要支持可选行为时，“选项模式”（Options Pattern）是事实上的标准做法，远优于为每个配置变体单独定义函数（如 MarshalWithOptions）。它不仅符合 Go 的简洁哲学，还天然支持未来新增选项而无需修改函数签名，彻底避免 API 爆炸。
✅ 正确做法：使用函数式选项（Functional Options）
核心思想是定义一个不可导出的函数类型 Option，并让每个选项作为返回该类型的函数：
// Option 是一个配置函数类型
type Option func(*MarshalOptions)
// MarshalOptions 定义所有可配置项（通常保持私有）
type MarshalOptions struct {
OnlyStdClass bool
Indent string
SkipNil bool
}
// 预定义的选项构造函数（首字母大写，对外暴露）
func WithOnlyStdClass(v bool) Option {
return func(o *MarshalOptions) {
o.OnlyStdClass = v
}
}
func WithIndent(indent string) Option {
return func(o *MarshalOptions) {
o.Indent = indent
}
}
func WithSkipNil(skip bool) Option {
return func(o *MarshalOptions) {
o.SkipNil = skip
}
}
然后将主函数改为接受可变参数 ...Option：
func Marshal(input interface{}, opts ...Option) ([]byte, error) {
// 构建默认配置
options := &MarshalOptions{
OnlyStdClass: false,
Indent: "",
SkipNil: false,
}
// 应用所有传入的选项（顺序执行，后者覆盖前者）
for _, opt := range opts {
opt(options)
}
// 实际序列化逻辑（此处简化示意）
if options.OnlyStdClass {
// ... 特殊处理逻辑
}
if options.Indent != "" {
// ... 格式化输出
}
return []byte("serialized"), nil
}
✅ 调用方式：清晰、组合自由、零开销
// 无选项（完全向后兼容）
data, err := Marshal(obj)
// 单一选项
data, err := Marshal(obj, WithOnlyStdClass(true))
// 多个选项（顺序重要，后设置的优先）
data, err := Marshal(obj,
WithIndent(" "),
WithSkipNil(true),
)
// 从切片展开（适合动态配置）
var dynamicOpts []Option
if needStdClass {
dynamicOpts = append(dynamicOpts, WithOnlyStdClass(true))
}
data, err := Marshal(obj, dynamicOpts...)
⚠️ 注意事项与最佳实践
-
不要暴露
MarshalOptions结构体字段为公开：应通过Option函数控制配置，防止用户绕过校验直接赋值； -
选项函数应幂等且无副作用：仅修改目标
*MarshalOptions，不触发 I/O 或状态变更； -
默认值必须合理：
MarshalOptions{}初始化应代表最常用、最安全的行为； -
避免过度设计：若仅有 1–2 个布尔开关，
...Option可能略重；但一旦选项数 ≥3 或含字符串/函数类配置，此模式立即体现价值； -
标准库印证：
http.Client的&http.Client{Transport: ...}构造、sql.OpenDB的&sql.ConnPoolConfig{}均属同类思想；context.WithValue/WithTimeout也是函数式选项的典型范例。
? 总结：
Marshal(input, opts...)不仅是“推荐方式”，更是 Go 社区共识的规范实践。它比MarshalWithOptions(input, opts)更具扩展性、更少侵入性、更易维护——当你今天添加WithIndent，明天添加WithCustomEncoder，API 依然干净如初。
