建造者模式在Golang中通过分离构造过程与表示实现灵活配置，适用于多可选属性、依赖校验的复杂结构体；定义不可导出目标结构体和链式调用的Builder结构体，提供带校验的WithXXX方法返回自身指针。
用 Golang 实现建造者模式，核心是把对象的构造过程与表示分离，让相同的构建流程能创建不同的配置结果。它特别适合需要分步设置多个可选属性、且部分属性有依赖或校验逻辑的复杂结构体。
定义目标结构体与建造者接口
先明确你要构建的对象类型，比如一个 HTTPClientConfig，包含超时、重试、证书路径、代理等字段。它本身应设为不可导出（小写首字母），避免外部直接初始化：
type httpClientConfig struct {
timeout time.Duration
maxRetries int
caCertPath string
proxyURL string
disableKeepAlive bool
}
再定义建造者接口（可选）或直接使用结构体方法链。Go 更常用后者——用一个 builder 结构体封装字段和方法：
立即学习“go语言免费学习笔记（深入）”；
type HTTPClientBuilder struct {
config *httpClientConfig
}
构造器函数返回新 builder 实例，并初始化默认值：
func NewHTTPClientBuilder() *HTTPClientBuilder {
return &HTTPClientBuilder{
config: &httpClientConfig{
timeout: 30 * time.Second,
maxRetries: 3,
disableKeepAlive: false,
},
}
}
提供链式设置方法（每个返回 *builder）
每个配置方法接收参数、校验（如 timeout > 0）、更新内部 config 字段，并返回 b *HTTPClientBuilder，实现链式调用：
- func (b *HTTPClientBuilder) WithTimeout(d time.Duration) *HTTPClientBuilder {
if d panic("timeout must be greater than 0")
}
b.config.timeout = d
return b
} - func (b *HTTPClientBuilder) WithRetry(max int) *HTTPClientBuilder {
if max panic("maxRetries cannot be negative")
}
b.config.maxRetries = max
return b
} - func (b *HTTPClientBuilder) WithCACert(path string) *HTTPClientBuilder {
if path != "" {
b.config.caCertPath = path
}
return b
}
添加校验与构建方法
Build 方法负责最终检查和返回不可变对象。建议在 Build 中做必要校验（例如：若启用了 TLS 但未提供证书路径，可报错）：
func (b *HTTPClientBuilder) Build() (*http.Client, error) {
// 可选：校验逻辑
if b.config.caCertPath != "" {
if _, err := os.Stat(b.config.caCertPath); os.IsNotExist(err) {
return nil, fmt.Errorf("CA cert file not found: %s", b.config.caCertPath)
}
}
// 构建真实 http.Client（示例逻辑）
transport := &http.Transport{
TLSClientConfig: &tls.Config{
RootCAs: x509.NewCertPool(), // 实际中需加载证书
},
IdleConnTimeout: b.config.timeout,
MaxIdleConns: 100,
}
return &http.Client{
Transport: transport,
Timeout: b.config.timeout,
}, nil
}
使用示例：分步配置，清晰直观
调用方可以按需组合配置，跳过不关心的项，语义清晰：
client, err := NewHTTPClientBuilder().
WithTimeout(15 * time.Second).
WithRetry(5).
WithCACert("./certs/ca.pem").
Build()
if err != nil {
log.Fatal(err)
}
// client 已就绪
也支持只设关键项：
client, _ := NewHTTPClientBuilder().WithTimeout(5 * time.Second).Build()
这种写法比传一大串参数或手动 new + 赋值更安全、易读、易维护。
