应避免直接用 map[string]interface{} 解析 yaml/json 后手动递归取值，因其缺乏空安全机制，易因 nil 或类型错误 panic；推荐优先使用结构体配合 yaml.unmarshal 的匿名字段提升，或 mapstructure 的 ,squash 标签实现扁平化访问。
为什么嵌套结构体字段访问总出 panic
直接用 map[string]interface{} 解析 YAML/JSON 后，再手动递归取 data["database"]["host"]，很容易在某层为 nil 或类型不对时崩溃。Go 的 interface{} 没有空安全访问机制，data["database"] 返回的是 interface{}，强转 map[string]interface{} 前必须先判空、判类型。
- 常见错误：未检查
data["database"] == nil就直接data["database"].(map[string]interface{}) - 更隐蔽的问题：YAML 中
database:后跟空行或null，解出来是nil，不是空map - 正确做法是封装一层安全访问函数，或——更推荐——绕过动态 map，直接进 struct
用 mapstructure + ,squash 实现字段自动提升
当配置结构天然分层（比如 server、database、cache 各自一个子结构），但你希望最终配置对象扁平化（如 cfg.DBHost 而非 cfg.Database.Host），mapstructure 的 ,squash 是最轻量可靠的方案。
- 嵌入字段必须显式加
`mapstructure:",squash"`标签，匿名字段不会自动 squash - 支持指针嵌入：
Database *DatabaseConfig `mapstructure:",squash"`也能展开 - 如果嵌入结构体里还有嵌入，
,squash不递归，只作用于直接嵌入层；多层需每层都标 - 注意冲突：两个被 squash 的结构体若含同名字段（如都定义
Timeout int），后加载的会覆盖前一个
YAML 路径扁平化：用 "a.b.c" 键直接查值
当你无法预定义结构体（比如配置项完全由用户上传 YAML 决定），又不想写一堆 if v, ok := m["a"]; ok { if v2, ok := v.(map[string]interface{})...，可把原始 YAML 先扁平成 map[string]string。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 键名用点号路径生成，如
{a: {b: {c: "x"}}}→"a.b.c" → "x" - 所有值统一转字符串，避免类型判断；需要其他类型时再用
strconv.Atoi等转换 - 对数组处理要小心：
a: [{b: 1}, {b: 2}]扁平后是"a.0.b" → "1"、"a.1.b" → "2"，索引不可省略 - 不适用于含复杂类型（如嵌套 map 与 slice 混用）的场景，此时仍建议走 struct + validate 路线
yaml.Unmarshal 本身就能扁平，别画蛇添足
Go 标准方式解析 YAML 时，只要结构体用匿名字段嵌入，yaml.Unmarshal 默认就做字段提升——根本不需要 mapstructure 或额外扁平逻辑。
- 写法：
type Config struct { Server ServerConfig; Database DatabaseConfig }→ 访问cfg.Server.Port - 但改成匿名字段：
type Config struct { ServerConfig; DatabaseConfig }→cfg.Port直接可用 - 前提是字段 tag 对齐：
ServerConfig里Port int `yaml:"port"`，顶层结构体无需重复 tag - 注意：匿名字段不能是指针，
*ServerConfig不会提升字段；要用指针请改用mapstructure或手动赋值
真正容易被忽略的是：YAML 的 !!int、锚点引用、多文档（--- 分隔）这些特性，手写扁平逻辑几乎不可能兼容，而 gopkg.in/yaml.v3 原生支持。别为了“看起来扁平”放弃成熟解析器的健壮性。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
