Go中建造者模式通过结构体+链式方法+可选配置函数实现,将复杂对象构造与表示分离,支持分步定制;典型流程为定义Product、Builder、WithXxx方法和Build验证。

在 Go 语言中应用建造者模式,核心是**将对象的构造过程与表示分离,支持分步骤、可定制地创建复杂结构**。Go 没有构造函数重载或默认参数,也没有类继承体系,因此建造者模式常通过结构体 + 链式方法(返回指针)+ 可选配置函数来实现,既清晰又符合 Go 的简洁哲学。
定义目标结构体(Product)
先明确你要构建的复杂对象。它通常是字段较多、部分字段可选、存在约束或依赖关系的结构体。
- 字段尽量导出(首字母大写),便于建造者设置
- 避免暴露未完成状态——内部字段可设为非导出,仅通过建造者安全赋值
- 示例:构建一个 HTTP 请求配置
type RequestConfig struct { method string url string headers map[string]string timeout time.Duration retries int body []byte }
创建建造者结构体(Builder)
建造者是一个独立结构体,持有目标对象的字段副本,并提供一系列“设置方法”。每个方法修改自身并返回 *Builder,实现链式调用。
- 建造者字段通常与目标结构体一致,但全部导出,方便初始化和修改
- 提供一个 NewXXXBuilder() 函数作为入口,返回初始化的建造者实例
- 例如:
type RequestConfigBuilder struct { method string url string headers map[string]string timeout time.Duration retries int body []byte }func NewRequestConfigBuilder() RequestConfigBuilder { return &RequestConfigBuilder{ headers: make(map[string]string), timeout: 30 time.Second, retries: 3, } }
实现链式设置方法(Step-by-step customization)
每个设置方法接收参数,更新对应字段,并返回 b *RequestConfigBuilder,支持连续调用。
本文档主要讲述的是j2me3D游戏开发简单教程; 如今,3D图形几乎是任何一部游戏的关键部分,甚至一些应用程序也通过用3D形式来描述信息而获得了成功。如前文中所述,以立即模式和手工编码建立所有的3D对象的方式进行开发速度很慢且很复杂。应用程序中多边形的所有角点必须在数组中独立编码。在JSR 184中,这称为立即模式。希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看
立即学习“go语言免费学习笔记(深入)”;
- 方法名建议用 WithXxx() 命名,语义清晰
- 对 map、slice 等引用类型注意深拷贝或防御性复制(如 headers 可用
mapcopy或重新 make) - 可加入简单校验(如 URL 非空、timeout > 0),提前报错
- 示例方法:
func (b *RequestConfigBuilder) WithMethod(method string) *RequestConfigBuilder { b.method = method return b }func (b RequestConfigBuilder) WithURL(url string) RequestConfigBuilder { b.url = url return b }
func (b RequestConfigBuilder) WithHeader(key, value string) RequestConfigBuilder { if b.headers == nil { b.headers = make(map[string]string) } b.headers[key] = value return b }
func (b RequestConfigBuilder) WithTimeout(d time.Duration) RequestConfigBuilder { if d > 0 { b.timeout = d } return b }
提供 Build() 方法并封装验证逻辑
Build() 是建造者的终点,负责:
- 检查必要字段是否已设置(如 URL 和 Method 不能为空)
- 组装最终的 RequestConfig 实例
- 返回不可变(或只读接口)的对象,或直接返回结构体值
- 若校验失败,可返回 error(推荐)或 panic(仅调试期)
- 示例:
func (b *RequestConfigBuilder) Build() (*RequestConfig, error) { if b.url == "" { return nil, fmt.Errorf("url is required") } if b.method == "" { b.method = "GET" }// 深拷贝 headers 避免外部修改影响后续复用 safeHeaders := make(map[string]string) for k, v := range b.headers { safeHeaders[k] = v } return &RequestConfig{ method: b.method, url: b.url, headers: safeHeaders, timeout: b.timeout, retries: b.retries, body: b.body, }, nil}
- 使用方式自然简洁:
cfg, err := NewRequestConfigBuilder(). WithURL("https://api.example.com/users"). WithMethod("POST"). WithHeader("Content-Type", "application/json"). WithTimeout(5 * time.Second). Build() if err != nil { log.Fatal(err) }









