用 Viper 读取 YAML/JSON 配置最简路径是：初始化 SetConfigName 和 AddConfigPath，调用 ReadInConfig 自动识别格式，再用 GetString 等方法读取；需手动处理热重载、写回文件和环境隔离。
用 viper 读取 YAML/JSON 配置文件最简路径
viper 是 Go 生态中事实标准的配置库，支持自动监听文件变更、多格式、环境变量覆盖。不用它，自己解析文件+热重载会重复造轮子且易出错。
常见错误是直接用 yaml.Unmarshal 读文件后忽略错误处理，或没设默认值导致字段为空 panic。viper 能统一解决。
- 安装：
go get github.com/spf13/viper - 基础读取只需三步：初始化
viper.SetConfigName("config")、viper.AddConfigPath("./conf")、viper.ReadInConfig() - 支持格式自动识别，只要文件名带后缀（如
config.yaml），无需手动指定SetConfigType - 读取值统一用
viper.GetString("server.port")，嵌套字段用点号分隔，不区分大小写
viper.SetConfigName("config")
viper.AddConfigPath("./conf")
viper.AutomaticEnv() // 启用环境变量覆盖
err := viper.ReadInConfig()
if err != nil {
panic(fmt.Errorf("fatal error config file: %w", err))
}
port := viper.GetInt("server.port") // 自动转 int，未设置则为 0
更新配置文件时必须绕开 viper 的只读陷阱
viper 默认不提供写回文件能力——它设计为「读取+合并」，不是「读写代理」。想改完存回去，得自己序列化。
容易踩的坑是调用 viper.WriteConfig() 却没设输出路径，结果写到当前目录的 ./config.json，或因权限失败静默丢弃。
立即学习“go语言免费学习笔记（深入）”；
-
viper.WriteConfig()只写到viper.ConfigFileUsed()返回的路径，若没显式调用ReadInConfig()，它可能为空 - 安全做法：先用
viper.ConfigFileUsed()拿到真实路径，再手动os.WriteFile写入新内容 - YAML 更新要小心结构体 tag：确保字段有
yaml:"field_name"，且类型兼容（如int字段不能塞字符串） - 更新前建议备份原文件，尤其生产环境
cfgPath := viper.ConfigFileUsed() data, _ := yaml.Marshal(viper.AllSettings()) os.WriteFile(cfgPath+".bak", data, 0644) os.WriteFile(cfgPath, data, 0644)
热重载配置需主动监听，viper 不自动刷新内存值
viper 提供 viper.WatchConfig()，但它只是监听文件变化并触发回调，不会自动更新你已取出来的变量值。很多人以为调了就万事大吉，结果老值还在用。
典型场景：HTTP server 启动后，修改 config.yaml 的 log.level，但日志级别没变——因为代码里早把 viper.GetString("log.level") 结果缓存到全局变量了。
- 必须在
OnConfigChange回调里重新读取关键字段，或触发组件 reload（如重置 logger 实例） - 避免在 init 或 main 开头一次性读配置到结构体，改用函数封装：每次需要时调
getLogLevel()，内部走viper.GetString - 注意并发：回调和业务逻辑可能同时访问 viper，但 viper 的读操作是 safe 的，写操作（如
Set）需加锁
viper.WatchConfig()
viper.OnConfigChange(func(e fsnotify.Event) {
log.Println("Config file changed:", e.Name)
// 这里重新加载影响运行时的配置项
newLevel := viper.GetString("log.level")
setLoggerLevel(newLevel)
})
环境隔离靠 Viper 的配置叠加，别硬编码判断
用 viper.SetEnvPrefix("APP") + viper.AutomaticEnv() 就能从 APP_SERVER_PORT 读值，但更关键的是用 viper.SetConfigName("config") + viper.SetConfigType("yaml") + 多级路径实现环境优先级：
- 按顺序加载：
./conf/config.yaml→./conf/config.development.yaml→./conf/config.production.yaml，后加载的覆盖前一个 - 通过
viper.GetString("env")动态拼接环境配置名，再ReadInConfig()加载，比 if-else 分支干净得多 - 环境变量最高优先级，适合 CI/CD 注入敏感配置（如数据库密码），但别把整个结构体都扔环境变量里，维护成本高
复杂点在于配置来源混合时的调试：用 viper.AllSettings() 打印最终合并结果，比猜哪个值从哪来快得多。
