建造者模式用于构建含必填与可选字段的复杂对象，避免参数过多的构造函数。通过链式调用逐步设置属性，确保必填项校验，提升代码可读性与维护性，适用于配置对象或API请求体构建。
在Go语言中，建造者模式（Builder Pattern）是一种创建型设计模式，适用于构建复杂对象，尤其是当对象的构造过程涉及多个可选字段或步骤时。它能有效避免“伸缩构造器反模式”（telescoping constructor），让代码更清晰、易维护。
为什么需要建造者模式
假设你要创建一个User结构体，包含姓名、邮箱、年龄、地址、电话等多个字段，其中一些是必填，一些是可选。如果直接用构造函数传参，要么参数太多，要么需要定义多个构造函数。
使用建造者模式，你可以：
- 逐步设置对象属性
- 确保必填字段不被遗漏
- 提升代码可读性和灵活性
实现建造者模式的基本结构
以构建一个用户信息为例：
立即学习“go语言免费学习笔记（深入）”；
type User struct {
Name string
Email string
Age int
Address string
Phone string
}
type UserBuilder struct {
user User
}
接下来定义构建方法：
func NewUserBuilder(name, email string) *UserBuilder {
return &UserBuilder{
user: User{Name: name, Email: email},
}
}
func (b *UserBuilder) SetAge(age int) *UserBuilder {
b.user.Age = age
return b
}
func (b *UserBuilder) SetAddress(address string) *UserBuilder {
b.user.Address = address
return b
}
func (b *UserBuilder) SetPhone(phone string) *UserBuilder {
b.user.Phone = phone
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("Alice", "alice@example.com").
SetAge(30).
SetAddress("Beijing").
SetPhone("13800138000").
Build()
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", user)
这种方式链式调用清晰明了，尤其适合配置类对象或API请求体的构建。
注意事项与优化建议
在实际使用中注意以下几点：
- 建造者不一定是导出的（即UserBuilder可以是小写userBuilder），只暴露工厂函数和构建方法
- Build方法中加入必要校验，保证对象完整性
- 若字段较多，可考虑分阶段构建（如先设必填，再设可选）
- 避免过度设计——简单对象不需要建造者
基本上就这些。建造者模式在Go中虽不如Java那样常见，但在需要构建复杂配置或DTO时，是个实用的选择。关键是通过链式调用提升可读性，同时控制对象的构造过程。
