建造者模式适合组装属性多、创建逻辑复杂且需分步构造的对象;Go通过结构体+链式调用+可选参数实现,含Builder类型、Set方法链式调用、Build校验与返回不可变对象。

建造者模式适合用来组装属性多、创建逻辑复杂、且需要分步骤构造的对象。Golang 没有构造函数重载和方法重载,但通过结构体 + 链式调用 + 可选参数的 Builder 实现,既清晰又灵活。
定义 Builder 结构体与目标对象
先设计最终要构建的复杂对象(比如 ServerConfig),再为其配套一个 Builder 类型(如 ServerConfigBuilder)。Builder 内部持有目标对象字段的副本,提供设置方法并返回自身,支持链式调用。
示例:
type ServerConfig struct {
Host string
Port int
TLS bool
Timeout int
LogLevel string
}
type ServerConfigBuilder struct {
config ServerConfig
}
func NewServerConfigBuilder() *ServerConfigBuilder {
return &ServerConfigBuilder{
config: ServerConfig{
Port: 8080,
Timeout: 30,
LogLevel: "info",
},
}
}
为每个可配置项提供 Set 方法
每个 SetXXX 方法只负责更新对应字段,并返回 *ServerConfigBuilder,保证链式调用不断开。不校验或执行副作用,保持 Builder 轻量。
立即学习“go语言免费学习笔记(深入)”;
- SetHost(host string) *ServerConfigBuilder
- SetPort(port int) *ServerConfigBuilder
- EnableTLS() *ServerConfigBuilder(布尔开关常用无参方法)
- SetTimeout(seconds int) *ServerConfigBuilder
- SetLogLevel(level string) *ServerConfigBuilder
实现示例:
func (b *ServerConfigBuilder) SetHost(host string) *ServerConfigBuilder {
b.config.Host = host
return b
}
func (b *ServerConfigBuilder) EnableTLS() *ServerConfigBuilder {
b.config.TLS = true
return b
}
提供 Build() 方法完成最终组装
Build() 是 Builder 的终点,它应做两件事:一是校验必要字段(如 Host 不为空),二是返回不可变的最终对象(通常返回值类型是结构体而非指针,避免外部篡改)。
校验失败时可 panic 或返回 error —— 推荐返回 error 更可控:
func (b *ServerConfigBuilder) Build() (*ServerConfig, error) {
if b.config.Host == "" {
return nil, fmt.Errorf("Host is required")
}
// 可选:深拷贝或冻结字段(如转为只读字段)
cfg := b.config // 值拷贝,安全
return &cfg, nil
}
使用方式简洁直观
用户无需记忆参数顺序,不用传一堆零值占位,也不用手动初始化中间状态。组合过程语义清晰,IDE 还能自动补全提示。
示例调用:
cfg, err := NewServerConfigBuilder().
SetHost("api.example.com").
SetPort(443).
EnableTLS().
SetTimeout(60).
SetLogLevel("debug").
Build()
if err != nil {
log.Fatal(err)
}
// cfg 已就绪,可直接使用
基本上就这些。Builder 在 Golang 中不是靠语法糖,而是靠显式设计和链式约定达成的——不复杂但容易忽略校验和不可变性。










