建造者模式用于简化复杂对象构造，通过链式调用设置字段，提升可读性与维护性。Go无构造函数，当结构体字段多、存在必填校验或默认值时，直接初始化易出错且不清晰。使用Builder可逐步构建对象，在Build阶段统一验证，如User需Name和Email非空。可通过NewUserBuilder预设默认值（如Age=18、IsActive=true），并提供SetName、SetEmail等方法实现链式调用。还可扩展为函数选项模式（UserOption），支持灵活传入选项，如WithAddress、WithPhone。适用于构造逻辑复杂、需校验或有多种配置组合的场景，避免重复代码。简单对象无需使用，应权衡简洁性与灵活性。
在 Go 语言中，建造者（Builder）模式常用于构造复杂对象，尤其是当结构体字段较多、初始化逻辑分散或存在多种组合配置时。它能有效提升代码可读性与可维护性，避免使用大量参数的构造函数或暴露过多细节。
为什么需要建造者模式
Go 没有构造函数，通常通过 New 函数创建实例。但当结构体字段增多，特别是可选字段多时，直接初始化容易出错且不清晰：
user := User{
Name: "Alice",
Age: 25,
Email: "alice@example.com",
Address: "",
Phone: "",
IsActive: true,
}
这种写法字段意义不明确，且难以控制必填与可选逻辑。建造者模式通过链式调用逐步设置属性，让构造过程更直观。
实现一个简单的建造者
以构建 User 对象为例，定义 Builder 结构体并提供设置方法：
立即学习“go语言免费学习笔记（深入）”；
type User struct {
Name string
Age int
Email string
Address string
Phone string
IsActive bool
}
type UserBuilder struct {
user *User
}
func NewUserBuilder() *UserBuilder {
return &UserBuilder{user: &User{}}
}
func (b *UserBuilder) SetName(name string) *UserBuilder {
b.user.Name = name
return b
}
func (b *UserBuilder) SetAge(age int) *UserBuilder {
b.user.Age = age
return b
}
func (b *UserBuilder) SetEmail(email string) *UserBuilder {
b.user.Email = email
return b
}
func (b *UserBuilder) SetAddress(addr string) *UserBuilder {
b.user.Address = addr
return b
}
func (b *UserBuilder) SetPhone(phone string) *UserBuilder {
b.user.Phone = phone
return b
}
func (b *UserBuilder) Activate() *UserBuilder {
b.user.IsActive = true
return b
}
func (b *UserBuilder) Build() (*User, error) {
if b.user.Name == "" {
return nil, fmt.Errorf("name is required")
}
if b.user.Email == "" {
return nil, fmt.Errorf("email is required")
}
return b.user, nil
}
使用方式非常清晰：
user, err := NewUserBuilder().
SetName("Bob").
SetAge(30).
SetEmail("bob@example.com").
SetPhone("13800138000").
Activate().
Build()
if err != nil {
log.Fatal(err)
}
支持可选配置与默认值
可以在 NewUserBuilder 中预设默认值，比如默认激活状态为 true，年龄默认 18：
func NewUserBuilder() *UserBuilder {
return &UserBuilder{
user: &User{
IsActive: true,
Age: 18,
},
}
}
这样即使不调用 SetAge 或 Activate，也能保证基本可用状态。同时保留覆盖能力。
也可以引入“配置函数”风格，实现更灵活的扩展：
type UserOption func(*UserBuilder)
func WithAddress(addr string) UserOption {
return func(b *UserBuilder) {
b.SetAddress(addr)
}
}
func WithPhone(phone string) UserOption {
return func(b *UserBuilder) {
b.SetPhone(phone)
}
}
// 修改构造函数接受选项
func NewUserBuilderWithOptions(name, email string, opts ...UserOption) (*User, error) {
builder := NewUserBuilder().SetName(name).SetEmail(email)
for _, opt := range opts {
opt(builder)
}
return builder.Build()
}
调用示例：
user, err := NewUserBuilderWithOptions(
"Charlie",
"charlie@example.com",
WithAddress("Beijing"),
WithPhone("13900139000"),
)
何时使用建造者模式
建造者模式适合以下场景：
- 对象构造过程复杂：多个必填/可选字段，存在依赖关系
- 需要验证输入：Build 阶段统一校验合法性
- 希望链式调用提升可读性：代码表达意图更清晰
- 避免重复的初始化逻辑：封装通用构造流程
对于简单结构体，直接初始化即可，不必过度设计。
基本上就这些。建造者模式在 Go 中虽不如 Java 那样常见，但在构造复杂对象时确实能显著改善代码质量。关键是根据实际需求权衡简洁性与灵活性。
