Go解析配置核心在于结构体字段必须首字母大写才能被解析，小写字段静默为零值；可选字段须用指针区分缺失与零值；动态字段用json.RawMessage暂存；校验必须依赖validator库而非仅靠tag。
Go 解析复杂配置文件，核心不是选哪个库，而是结构体怎么写、错误怎么捕、字段怎么验。写错一个首字母，整个配置就静默失效；漏一次类型校验，线上服务可能用 0 端口启动。
结构体字段必须大写，否则解析永远为零值
这是最硬的规则，也是最多人栽坑的地方：json.Unmarshal、yaml.Unmarshal、xml.Unmarshal 全部只写入导出字段（首字母大写）。小写字段如 port、db_host 不管加什么 tag，解析后永远是零值，且不报错。
-
Port int `json:"port"`✅ 正确：字段名大写，tag 控制映射 -
port int `json:"port"`❌ 错误：字段未导出，解析后port永远是 0 - 嵌套结构里所有字段也必须大写，包括匿名字段里的字段
- 想跳过某个字段？用
json:"-"，比注释掉更可靠
可选字段必须用指针，否则无法区分“没写”和“写了零值”
比如配置里没出现 "timeout"，你希望知道它是缺失，而不是默认设成 0 秒——后者可能被当成用户显式设置了超时为 0，直接导致连接立即断开。
- 用
Timeout *int `json:"timeout"`：缺失或"timeout": null都让Timeout为nil - 使用前必须判空：
if req.Timeout != nil { use(*req.Timeout) }，否则 panic - 同理适用于
*string、*bool，但注意*bool的nil和false语义完全不同 - 别用
omitempty标签代替指针——它只影响序列化输出，不解决反序列化时的歧义
动态或混合类型字段，用 json.RawMessage 而不是 interface{}
当某个配置字段可能是对象、数组、布尔甚至 null（比如 "features"），硬塞进 map[string]interface{} 会导致后续多层类型断言繁琐且易 panic。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 定义为
Features json.RawMessage `json:"features"`，只暂存原始字节，不解析 - 后续按需解析：
json.Unmarshal(req.Features, &featureMap)或json.Unmarshal(req.Features, &featureSlice) - 若要检查字段是否存在，可先解析为
map[string]json.RawMessage，再查 key -
RawMessage不校验 JSON 合法性，错误会延迟到真正Unmarshal时暴露，更可控
校验不能只靠 tag，必须用 validator 做运行时检查
json:"port" 这类 tag 只管字段映射，不管值合不合理。比如 "port": -1 会被静默转成 0；"port": "abc" 才报错，但错误信息模糊（“cannot unmarshal string into Go value of type int”）。
- 结构体加
validatetag：Port int `json:"port" validate:"required,min=1,max=65535"` - 解析后调用
validator.Validate(&cfg)，能明确返回Key: 'Config.Port' Error:Field validation for 'Port' failed on the 'min' tag - 别依赖
viper.SetTypeByDefaultValue(true)之类机制——它对嵌套字段、自定义类型支持弱，且掩盖真实问题 - 环境变量注入时，同样要走 validator，因为
PORT=abc也会被转成 0
真正麻烦的从来不是嵌套层数或格式种类，而是某一级标签名拼错、某个字段忘了加指针、某处解引用前没判空——这些错误不会编译失败，也不会立刻 panic，而是在某个边缘请求里悄悄把服务绑在 localhost:0 上。
