命令行参数优先级最高但需手动控制加载顺序：先 flag.parse() 再 bindpflag，环境变量需 automaticenv() 在 mergeconfig 后调用，viper 不自动合并，所有赋值必须显式编码。
命令行参数能覆盖配置文件，但必须手动控制加载顺序和赋值逻辑——Go 标准库不提供自动优先级合并。
flag.Parse() 必须在所有配置加载之后执行？错，它得最先跑
常见错误是先 viper.ReadInConfig() 加载 config.yaml，再调用 flag.Parse()，结果命令行参数压根没进配置结构体。因为 flag 解析后只是存进 flag.Flag 实例里，不会自动写入 viper 或你的 struct。
- 正确顺序：先定义
flag.String("port", "8080", "")等，立即调用flag.Parse() - 再检查
flag.Lookup("port").Value.String()是否非空；非空才覆盖当前配置字段 - 别依赖
flag.CommandLine.Visit()遍历——它只返回已设置的 flag，但你得自己判断“是否真被用户传了”，flag.Lookup().Value.String()更直接 - 如果用了
viper.BindPFlag("port", flag.Lookup("port"))，注意：必须在flag.Parse()之后 调用，否则绑定的是未解析的默认值
viper.AutomaticEnv() 默认不覆盖配置文件？对，它排在最后
viper.AutomaticEnv() 只是注册一个配置源，不改变优先级顺序。默认它被加在源列表末尾，所以永远赢不了 ReadInConfig() 读到的 YAML 值。
- 要让环境变量真正覆盖文件，必须先
viper.Reset()（尤其热重载时），再按「高→低」手动加源：先viper.SetEnvPrefix("APP")+viper.AutomaticEnv()，再viper.SetConfigFile("config.yaml")+viper.ReadInConfig() - 同时配
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))，否则server.port找不到SERVER_PORT - 调试时用
viper.GetEnvVars()看映射是否生成成功，避免前缀或分隔符错位
多配置文件合并靠 MergeConfig，不是 ReadInConfig
viper.ReadInConfig() 只加载第一个匹配文件（如 config.yaml），不会自动叠加 config.prod.yaml 或 config.local.yaml。
- 想实现「基础配置 → 环境配置 → 本地覆盖」三层，得手动
os.ReadFile各文件内容，再按顺序调用viper.MergeConfig(bytes) - 顺序即优先级：后一次
MergeConfig中同 key 会覆盖前一次，嵌套字段（如database.host）递归合并，不是全量替换 - 环境变量仍应作为最终层，在所有
MergeConfig之后再调viper.AutomaticEnv()，否则会被中间层覆盖掉 - 文件不存在时
os.ReadFile返回 error，别忽略——用if !os.IsNotExist(err)区分是缺失还是真错误
go-flags 里 env 标签和 long 标签共存时谁生效？long 优先
go-flags 支持 env:"APP_PORT" 标签，但它只在对应 long（如 long:"port"）未被命令行指定时才读取环境变量。一旦你写了 --port=3000，APP_PORT 就完全被跳过。
- 字段必须同时带
long和env标签，例如：Port int `long:"port" env:"APP_PORT" default:"8080"` -
short:"p"不触发 env 查找，只有long或无 flag 时才查 env - 调试时用
parser.Visit()遍历已设置选项，确认是 flag 还是 env 生效，避免误判 - 子命令不自动继承父 flag，若需共享
--config，得在主 parser 定义后，用parser.FindOptionByLongName("config")手动提取并透传
最易被忽略的一点：所有优先级逻辑都依赖「你显式写的赋值语句」。没有魔法函数能把命令行、env、file 自动 merge 成一个最终 config 结构体——哪怕用了 viper，也得靠你控制 BindPFlag、MergeConfig、AutomaticEnv 的调用时机和顺序。漏掉 reset、错位顺序、忽略空字符串判断，都会让高优先级值静默失效。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
