链式调用必须返回指针以维持状态，所有with方法需返回*builder；build是唯一校验入口，字段导出控制封装强度，嵌套配置宜用函数选项模式，返回对象须冻结可变状态。
链式调用必须返回指针，否则调用会中断
Go 里链式调用不是语法糖，而是靠方法显式返回 *Builder 实现的。如果某个 WithName 方法返回值是 UserBuilder（值类型）或 void，后续调用就拿不到修改后的状态，等于白设。
- 结构体字段必须在建造者内部持有可修改副本（比如
user *User），不能只存原始值 - 所有设置方法签名必须统一为
func (b *XxxBuilder) WithXxx(v T) *XxxBuilder - 初始化函数如
NewConfigBuilder()必须返回指针，否则第一次调用就失去地址引用
Build 方法是唯一校验入口，别在中间步骤抛错
Go 强制显式错误处理，但链式调用天然不支持中途“断链”。把校验逻辑塞进 WithName 这类 setter 里，会导致调用链提前终止、错误无法累积、API 行为不一致。
-
Build()是唯一适合做必填校验、格式验证、依赖检查的地方 - 若需提前拦截（比如邮箱格式），可在 setter 内部做轻量预处理（如正则匹配），但不要
return nil, err - 错误应统一用
error类型返回，避免混用 panic 或日志打印代替错误传播
字段导出控制决定封装强度和扩展性
目标结构体（如 Config）的字段是否导出，直接影响建造者能否安全封装初始化逻辑。
- 若
Config字段全小写（未导出），外部无法直接构造，强制走Build()，能保证校验必执行 - 若字段导出，用户可能绕过建造者直接字面量初始化，破坏一致性
- 建造者结构体本身字段可导出也可不导出——只要它的方法都导出，外部就无需关心内部字段是否公开
嵌套配置建议用函数选项模式替代深层链式
当配置项本身是复杂结构（如 tls.Config 或自定义 RetryPolicy），硬写成 WithTLS(...).WithRetry(...) 会让 Builder 膨胀且难以复用。
- 优先用函数选项（functional options）：定义
func(*ConfigBuilder) error类型参数，Build()内统一 apply - 例如：
WithTLS(&tls.Config{...})和WithRetry(RetryPolicy{Max: 3})都是独立 option，不耦合在 Builder 方法里 - 这样既能保持链式外观（
NewBuilder().WithTLS(...).WithRetry(...).Build()），又避免 Builder 接口爆炸
*Config 若含 map 或 slice 字段，且未做深拷贝或冻结处理，外部修改会污染建造者缓存——这在并发场景下尤其危险。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
