Go中结构体不可变靠私有字段+值传递+无setter实现逻辑契约：字段全小写、禁导出、用WithName()返回新实例、slice/map需深拷贝、接收者为值类型、暴露只读接口隔离。
Go 里没有 const struct 或 immutable 关键字，所谓“值对象不可变”，本质是靠字段私有化 + 值类型传递 + 拒绝暴露可变引用实现的逻辑契约——违反它，不是编译报错，而是并发时悄无声息地出问题。
结构体字段必须全小写，且不提供 setter 方法
这是不可变设计的起点。只要有一个导出字段（首字母大写），外部包就能直接赋值，整个不可变性就失效了。
-
name string✅ 安全：外部无法访问或修改 -
Name string❌ 危险：u.Name = "new"直接破坏契约 - 不要为字段提供
SetName()这类方法——那是可变对象的写法；改用WithName()返回新实例 - 构造函数如
NewUser()应返回值类型（User），而非指针（*User），避免调用方意外取地址修改
含 slice/map 的字段必须深拷贝初始化和读取
值类型拷贝只复制结构体头，不复制底层数组或哈希表。若字段是 []string 或 map[string]int，不处理就会共享底层数据。
- 初始化时：用
copy(dst, src)或append([]T(nil), src...)拷贝 slice；对 map 要手动遍历赋值或用maps.Clone()（Go 1.21+） - 读取时：
func (u User) Tags() []string { return append([]string(nil), u.tags...) }—— 不要直接return u.tags - 错误示例：
func (u User) Options() map[string]string { return u.options }→ 并发中一改就污染原始数据 - 如果字段是
*sync.Mutex或*bytes.Buffer，必须确保该指针指向的对象本身也“不可变”或已隔离
所有“更新”操作必须返回新实例，禁止原地修改
不可变对象没有“修改”，只有“派生”。接收者必须是值类型（func (u User) WithAge(a int) User），不是指针（*User）。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 值接收者保证：方法内对
u.age = a的赋值只影响副本，不影响调用方持有的原值 - 指针接收者（
func (u *User) SetAge(a int)）是明确可变信号，与不可变目标冲突 - 多个字段更新建议组合：如
u.WithAge(30).WithHost("api.example.com")，链式调用清晰表达意图 - 注意性能：若结构体过大（如含 MB 级
[]byte），每次WithXxx()都拷贝成本高，此时应权衡是否改用只读指针 + 明确文档警告
对外暴露只读接口，彻底封死转型可能
即使结构体设计得再严谨，只要把指针传出去，别人就能强制转型并修改。用接口收口是最稳妥的隔离方式。
- 定义只读接口：
type ConfigReader interface { Host() string; Timeout() time.Duration } - 内部实现用小写结构体：
type config struct { host string; timeout time.Duration } - 构造函数返回接口：
func NewConfig(h string, t time.Duration) ConfigReader { return &config{host: h, timeout: t} } - 关键点：外部无法将
ConfigReader转回*config，也无法通过反射获取未导出字段地址 - 接口方法仍不能返回
map或slice原始引用——Labels() []string可以，但Labels() map[string]string绝对不行
最容易被忽略的是嵌套引用类型：一个看似干净的 User 结构体，只要里面藏了 map、slice、chan 或任意指针，就不是真正的不可变。判断标准只有一个——调用方拿到返回值后，能否在不调用你任何方法的前提下，让原始对象状态发生变化。能，就是漏了；不能，才算过关。
