gopkg.in/yaml.v3是当前最稳妥、最常用的选择，因其修复了v2已归档导致的反序列化漏洞、嵌套map类型推断错误、空字段处理不一致等问题，并支持YAML 1.2规范、精确列级错误提示及锚点/别名等高级特性。
Go 语言解析 YAML 配置文件，gopkg.in/yaml.v3 是当前最稳妥、最常用的选择；其他库要么维护停滞，要么在结构体标签兼容性、锚点/别名支持或错误提示上存在明显短板。
为什么不用 gopkg.in/yaml.v2？
v2 已停止维护（最后更新是 2019 年），不支持 YAML 1.2 的部分特性（如显式布尔值 true/True 解析不一致），且对嵌套结构体的零值处理有 bug。v3 修复了这些，并统一了 omitempty 行为。
- v2 中
yaml:"field,omitempty"在 map 嵌套时可能意外丢字段；v3 严格按字段是否为零值判断 - v2 不支持
!!null或~显式空值；v3 将其映射为 Go 的nil或零值，更符合预期 - v2 的错误位置提示只到行号，v3 能精确到列（例如
yaml: unmarshal errors: line 5: cannot unmarshal !!str `abc` into int）
Unmarshal 时 struct tag 怎么写才不出错？
YAML 字段名和 Go 字段名不一致时，必须用 yaml tag 显式声明；漏写或拼错会静默失败（字段保持零值），而不是报错。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 推荐写法：
Port int `yaml:"port"`，小写 key 更符合 YAML 惯例 - 避免混用
json和yamltag：如果同时用于 HTTP API 和配置文件，建议分开定义两个 struct，或用map[string]interface{}+ 手动转换，避免 tag 冲突 - 嵌套结构体必须导出（首字母大写），否则
Unmarshal会跳过整个字段 - 切片字段若允许为空数组，不要加
omitempty—— 否则[]会被当作未设置而忽略
如何安全地做参数化配置（环境变量 + YAML 合并）？
纯 YAML 不适合多环境部署；直接在 YAML 里写 ${ENV} 不被 gopkg.in/yaml.v3 原生支持，必须自己实现替换逻辑。
立即学习“go语言免费学习笔记（深入）”；
- 先用
ioutil.ReadFile（Go 1.16+ 用os.ReadFile）读取原始 bytes，再用os.ExpandEnv或正则替换${VAR}为实际值，最后传给yaml.Unmarshal - 不要用
os.Setenv动态改环境变量来“欺骗”ExpandEnv—— 并发场景下会污染全局状态 - 若需多层覆盖（如 base.yaml + dev.yaml），建议用
go-yaml的yaml.Merge（非官方，需额外引入），或手动递归合并 map[string]interface{} - 敏感字段（如 password）应从文件外注入，YAML 中留空或占位符，运行时校验非空
真正容易被忽略的是：YAML 的锚点（&id）和别名（*id）在 v3 中默认启用，但若配置中用了循环引用（A 引用 B，B 又引用 A），Unmarshal 会 panic，且错误信息不提示具体位置 —— 必须靠人工检查或加 yaml.Node 预解析做引用图检测。
