应使用struct tag统一声明env/default/validate行为，解析器仅填充不掺杂业务逻辑；嵌套结构用匿名字段+yaml tag自然展开；特殊类型如time.Time需注册类型级解析函数；热重载须监听fsnotify.Write和Create事件并加延时读取，失败时必须保留旧配置。
别手写解析逻辑，尤其是格式识别和类型转换——这会快速撞墙。真正要解决的不是“怎么读文件”，而是“怎么把 YAML/JSON/TOML 映射到带验证逻辑的 struct，并支持运行时更新”。
用 struct tag 统一控制 env/default/validate 行为
把环境变量覆盖、默认值、校验规则全部声明在 struct 定义里，而不是在解析后硬编码判断。解析器只负责按需填充，不掺杂业务逻辑。
-
env:"PORT"表示该字段可被PORT=8080环境变量覆盖 -
default:"8080"在 YAML 缺失该字段时生效，但优先级低于环境变量 -
validate:"gt=0"是给go-playground/validator/v10用的，不是解析器自己 parse - 嵌套结构用匿名字段 +
yaml:"database"即可自然展开，不用额外 struct 包裹
注册自定义解析器处理特殊类型（如 time.Time）
当配置含 start_date: "2023-12-31" 这类非标准类型时，cleanenv 允许你注册类型级解析函数，而不是在 Unmarshal 后手动 time.Parse。
- 调用
cleanenv.RegisterTypeParser(reflect.TypeOf(time.Time{}), func(field reflect.Value, value string) error { ... }) - 函数内必须用
field.Set(reflect.ValueOf(t))赋值，不能直接field.Interface() = t - 注意：
time.Parse("2006-01-02", value)错误时必须返回 error，否则静默失败 - 别在 init 里注册多个同类型解析器——后注册的会覆盖前一个
热重载必须监听 fsnotify.Write 和 fsnotify.Create
编辑器保存配置文件时，常先写临时文件再 rename，只监听 fsnotify.Write 会漏掉事件。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 必须同时监听
fsnotify.Write和fsnotify.Create两种事件 - 事件触发后加
time.Sleep(100 * time.Millisecond)再读，防止读到截断内容 - reload 失败时不能丢弃旧配置，必须保留并记录日志，否则服务可能直接不可用
- 不要用轮询或定时器代替 fsnotify——延迟高、资源浪费、无法保证顺序
INI/XML/二进制等非主流格式，预处理比改解析器更可靠
go-ini 不支持内联注释，encoding/xml 不自动转 kebab-case，binary.Read 不支持 string——这些问题不该靠魔改库解决。
- INI 注释误判？用
regexp.MustCompile(`(?m)^\s*[;#].*$`)清洗原始[]byte，再传给ini.LoadSources - XML 标签名是
db-host但 struct 字段是DBHost？必须写DBHost string `xml:"db-host"`，大小写+连字符逐字符匹配 - 二进制配置含变长字符串？拆成两步：
binary.Read先读定长头（含长度字段），再用io.ReadFull手动读变长内容 - 所有预处理都操作
[]byte，别用strings.NewReader——遇到 GBK 或 BOM 会乱码
最易被忽略的是：struct 字段名必须首字母大写，否则无论 tag 怎么写，解析后永远是零值；还有就是 reload 失败时保留旧配置这个动作，很多人以为只是日志问题，其实它直接决定服务是否可用。
