viper.Get("server.port")返回nil是因为未启用嵌套键访问，默认只识别顶层key；需确保SetConfigType、SetConfigName、AddConfigPath在ReadInConfig前调用，并检查YAML缩进是否为全空格、无tab。
用 viper 读取 YAML 配置时，为什么 viper.Get("server.port") 返回 nil？
不是配置没加载，而是默认没开启键路径分隔符。viper 默认用 . 当分隔符，但必须显式启用嵌套访问——否则它只认顶层 key。
- 调用
viper.SetConfigType("yaml")后，立刻加viper.SetConfigName("config")和viper.AddConfigPath("./conf") - 在
viper.ReadInConfig()之前，加上viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))（如果要支持环境变量映射） - 最关键：确保
viper.AutomaticEnv()在ReadInConfig()之后调用，否则环境变量会覆盖刚读进来的 YAML 值 - 检查 YAML 文件缩进是否为空格（tab 会导致解析失败且无明确错误）
自定义结构体绑定时，viper.Unmarshal() 不填充字段的常见原因
Go 结构体字段必须是导出的（首字母大写），且 YAML tag 要和配置项完全匹配；viper 不会自动转换下划线/驼峰，也不会做类型推断容错。
- 结构体字段加
`yaml:"db_host"`tag，而不是依赖字段名自动映射 - 避免用
int接 YAML 中带小数点的数字（如timeout: 30.0），viper 默认解析为float64，应统一用float64或提前用viper.GetInt("timeout") - 嵌套结构体要逐层定义，不能靠
viper.Unmarshal(&cfg)自动展开未声明的 map[string]interface{} - 如果配置项缺失，
Unmarshal不报错也不补零值——建议配合viper.IsSet("db.host")做存在性校验
如何让配置热重载不崩掉正在运行的 HTTP server？
直接调用 viper.WatchConfig() 并在回调里改全局变量，大概率引发竞态——尤其是结构体指针被多 goroutine 同时读写时。
- 用
sync.RWMutex包裹配置结构体读写，读操作用RLock()，重载时用Lock() - 不要原地修改结构体字段，而是 new 一个新实例，校验通过后再原子替换指针：
atomic.StorePointer(¤tCfg, unsafe.Pointer(&newCfg)) - viper 的
WatchConfig()默认监听文件系统事件，但在容器中可能失效（如 ConfigMap 挂载为只读），此时应 fallback 到定期viper.ReadInConfig()+ etag 对比 - 重载失败时，日志必须包含原始错误和当前配置路径，否则线上无法定位是文件权限、语法错误还是网络挂载问题
不用 viper，纯标准库怎么安全解析 JSON/YAML 配置？
当项目极简或需完全掌控解析流程时，绕过第三方库更可控，但得自己补全缺失环节：类型校验、缺失字段提示、多源合并。
立即学习“go语言免费学习笔记（深入）”；
- 用
io/fs.WalkDir扫描./config/*.yaml，按字典序合并（后加载的覆盖前加载的） - 解析 YAML 用
gopkg.in/yaml.v3（非 v2），因 v3 支持yaml:",inline"和更准的类型推导 - 对关键字段（如
database.url）做required校验：解析后遍历结构体反射字段，检查yaml:",omitempty"字段是否为空 - 把最终配置序列化成 JSON 再反解一次，可提前暴露循环引用或不支持的类型（如
func、chan）
viper.ReadInConfig() 失败时只返回 error，但不告诉你具体哪一行 YAML 错了。真要优雅，得在包装层里捕获并补充上下文——比如把文件路径、行号、原始错误拼成一条可 grep 的日志。 
