当存在默认配置与用户配置需按零值填充、字段多且嵌套深、零值具有语义（如0表示未设置）时，应使用mergo.merge；否则手动赋值更安全可控。
什么时候该用 mergo.Merge 而不是手动赋值？
当你有明确的「默认配置结构体」和「用户覆盖结构体」，且字段多、嵌套深、零值有意义时，mergo.Merge 才值得引入。比如：Config 里有 Timeout（int）、Debug（bool）、DB（嵌套结构体）——这些字段若为 0 或 false，不一定是“未设置”，但你又想让它们被默认值填充，这时 mergo 的“只填零值”逻辑才真正起效。
常见错误现象：userConfig.Timeout = 0 是用户显式关掉超时，但 mergo.Merge(&userConfig, defaultConfig) 还是把它覆盖成了默认 30s；这说明你根本没区分「零值」和「未设置」，直接用 mergo 反而掩盖了语义。
- 如果所有字段都是「非空即有效」（如
string字段不允许为空字符串），那mergo就够用 - 如果需要支持「显式设为 0 / false / ""」，必须改用指针字段（
*int、*bool、*string），并配合mergo.WithOverride+ 自定义判断逻辑 - 嵌套结构体中含
map[string]interface{}或json.RawMessage时，mergo完全不处理，得先解出再单独合并
mergo.Merge 默认行为到底填哪些字段？
它只填充目标结构体中「当前值为 Go 零值」的导出字段，且递归进入所有导出的嵌套结构体。注意：它不看字段是否被赋过值，只比对运行时值是否等于 nil（指针）、0（数值）、""（字符串）、false（布尔）。
容易踩的坑：type Server struct { Port int `json:"port"` }，即使你写了 Port: 0，mergo 仍会用默认值覆盖它——因为 0 是零值。这不是 bug，是设计如此。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 切记：所有字段必须是导出的（首字母大写），否则
mergo直接跳过 - 如果字段是
map或slice，空 map（map[string]int{}）和 nil map 都算零值，都会被覆盖；但非空 map 不会被合并键值，只会整个替换 - 对
time.Duration、time.Time等自定义类型，需注册Transformer，否则按底层整数/结构体处理，可能出错
如何安全地合并含 json.RawMessage 和动态 map 的配置？
mergo 对 json.RawMessage 和 map[string]interface{} 完全无感——它既不会递归解析 RawMessage，也不会 merge map 的键值对，只会把整个值当黑盒替换。生产环境里，配置常含环境相关字段（如 "envs": {"prod": {...}, "dev": {...}}），这时必须绕过 mergo 直接控制合并流程。
正确做法：把动态部分声明为 Children json.RawMessage，而不是 Children map[string]interface{}；合并前先检查 len(raw) > 0，再决定是否 json.Unmarshal 到具体结构体，最后调用 mergo.Merge 处理已知结构部分。
- 不要在结构体里混用
map[string]interface{}和json.RawMessage：前者会丢失 null/missing 差异，后者能保留原始 JSON 语义 - 若要递归合并 RawMessage 内容，必须先
json.Unmarshal到目标结构体变量，再传给mergo.Merge，不能塞进主结构体靠mergo自动拉平 - 对
map[string]json.RawMessage，遍历 key 时逐个解包、合并，避免一次性全解导致 panic
为什么 mergo.WithOverride 有时不生效？
mergo.WithOverride 的作用是「覆盖目标字段，无论是否为零值」，但它不解决类型不匹配问题。最常踩的坑是：源字段是指针（*string），目标字段是值类型（string），此时即使加了 WithOverride，mergo 也拒绝赋值，静默跳过。
另一个典型场景：嵌入匿名结构体（type Config struct { HTTP; DB }），HTTP.Port 和 DB.Port 在反射层面字段名都是 Port，mergo 无法区分，会随机覆盖其中一个。
- 指针字段合并必须配
mergo.WithoutDereference，否则mergo试图解引用 nil 指针导致 panic - 含匿名字段的结构体，
mergo会把嵌入字段的字段名直接提升，极易冲突；建议显式命名（HTTP HTTPConfig）而非匿名嵌入 -
WithOverride对不可寻址字段（如 struct 字面量直接传入）无效，目标必须是指针（&dst）
mergo.Merge，而是判断哪些字段该让它填、哪些该自己控场、哪些压根不该暴露给 mergo。越靠近配置顶层，越要放弃“一键合并”幻想，转而用 json.RawMessage + 显式解包 + 分段 mergo 控制粒度。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
