Go不支持默认参数，推荐用结构体零值或函数选项模式；前者轻量适用于简单场景，后者灵活可扩展且向后兼容；需注意指针传递、并发安全及运行时求值时机。
Go 里没有默认参数，别硬套 Python 思路
Go 语言不支持函数参数默认值或命名参数，所以 func NewClient(timeout int, retries int) 这种写法一旦参数变多、部分可选，就很快失控。直接用结构体字段 + 零值语义是更 Go 的做法，而不是试图模拟其他语言的“可选参数”语法。
用结构体 + 函数选项（Functional Options）最灵活
这是目前社区主流且健壮的方案：定义一个私有函数类型（如 Option），每个配置项封装为一个返回该类型的函数。构造函数接收变长的 Option 切片，在内部依次 apply。
-
Option类型本质是func(*Config)，闭包捕获配置值并修改目标结构体 - 所有配置逻辑集中在构造函数内，调用方只看到清晰的链式风格：
NewServer(WithPort(8080), WithTimeout(5*time.Second)) - 新增配置项无需改函数签名，向后兼容；零值字段仍可被显式覆盖
- 注意：选项函数应在构造函数中按顺序执行，避免相互覆盖（比如
WithLogger和WithDebug如果都改同一字段，后者生效）
type Config struct {
Port int
Timeout time.Duration
Logger *log.Logger
}
type Option func(*Config)
<p>func WithPort(p int) Option { return func(c <em>Config) { c.Port = p } }
func WithTimeout(t time.Duration) Option { return func(c </em>Config) { c.Timeout = t } }</p><p>func NewServer(opts ...Option) <em>Server {
cfg := &Config{Port: 80, Timeout: 30 </em> time.Second}
for _, opt := range opts {
opt(cfg)
}
return &Server{cfg: cfg}
}简单场景直接用结构体字面量 + 零值
如果配置项少（≤3 个）、变更不频繁，跳过 Option 模式更轻量。Go 的结构体字面量天然支持字段选择性赋值，且零值（0、""、nil）通常有合理语义。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 定义导出结构体（如
HTTPClientOptions），字段全部导出 - 构造函数只接受一个
*HTTPClientOptions，允许传nil使用全零值 - 调用方写
NewHTTPClient(&HTTPClientOptions{Timeout: 10 * time.Second})即可，不用写一堆WithXXX - 缺点：无法做字段级校验（比如
Timeout ），也不如 <code>Option易扩展
别踩坑：接口嵌入、指针传递和并发安全
Functional Options 看似简单，但实际落地时容易忽略几个关键点：
立即学习“go语言免费学习笔记（深入）”；
- 所有
Option函数必须操作同一个*Config实例，不能在闭包里 new 新结构体再赋值——否则修改无效 - 如果
Config包含指针或 map/slice 字段（如Headers map[string]string），要深拷贝或初始化，否则多个实例共享底层数据引发并发问题 - 不要把
Option类型暴露到公共 API 外部（比如放在exported.go），它只是实现细节；导出的只有构造函数和配置结构体 - 如果配置项需要运行时动态计算（比如从环境变量读取），确保
WithXXX函数在调用时才执行，而不是在定义时求值
真正难的不是写出第一个 WithTimeout，而是当第 12 个配置项加入后，还能让所有人一眼看懂哪几个组合是合法的、哪些字段互斥、哪些必须非零——这靠文档和类型约束，不是靠语法糖。
