Viper 是 Go 配置管理事实标准，需设 config 路径、统一文件名、早初始化、设默认值、手动类型转换；热重载需注意文件系统限制，推荐轮询；安全注入需分步校验、tag 映射、必填检查；多环境用环境变量前缀，敏感配置走环境变量或 secrets。
用 viper 读取 YAML 配置文件最简路径
直接上手写配置中心，别从零造轮子——viper 是 go 生态事实标准，它能自动处理文件监听、环境变量覆盖、默认值 fallback，比手写 yaml.unmarshal 安全得多。
常见错误是只调用 viper.ReadInConfig() 却没设搜索路径，导致报错 Config File "config" Not Found in "[.]"。必须显式加 viper.AddConfigPath("./conf")（路径可自定义）。
实操建议：
- 配置文件名统一用
config.yaml，避免后缀大小写歧义（Windows 下CONFIG.YAML可能读不到） - 在
main()开头就初始化viper，早于任何业务逻辑，否则并发读配置可能 panic - 用
viper.SetDefault("log.level", "info")设默认值，比硬编码进结构体更灵活 - 不要依赖
viper.Unmarshal()自动类型转换——比如 YAML 里写timeout: 30s，viper 会当字符串读，得手动转time.ParseDuration(viper.GetString("timeout"))
热重载配置时为什么 reload 失败
调用 viper.WatchConfig() 后，修改文件却没触发回调，大概率是文件系统事件没捕获到。Linux/macOS 通常没问题，但 Docker 容器里挂载的 host 目录（尤其 Windows 主机 + WSL2）常因 inotify 限制失效。
实操建议：
- 在
WatchConfig()前加viper.OnConfigChange(func(e fsnotify.Event) { ... })，先确认回调是否注册成功 - 容器内运行时，改用轮询：启动 goroutine 每 2 秒调用一次
viper.ReadInConfig()，再比对viper.AllSettings()的 hash 值变化 - 热重载不等于实时生效——数据库连接池、HTTP client timeout 这类运行时参数，必须你自己写 reload hook 主动更新，viper 不会帮你关旧连接
如何安全地把配置注入 struct 而不 panic
直接 viper.Unmarshal(&cfg) 看似方便，但字段名不匹配或类型强转失败时会静默忽略或 panic。更稳的方式是分步校验。
实操建议：
- 用
viper.Get("server.port")手动取值，再做类型断言和范围检查（比如端口必须在 1–65535） - 结构体字段加
viper:"port"`tag，配合viper.UnmarshalKey("server", &cfg.Server)按 section 解析，缩小出错范围 - 必填字段用
viper.IsSet("database.url")显式校验，缺失时直接log.Fatal("missing required config: database.url") - 避免嵌套过深的 struct——YAML 里
auth.jwt.expiry对应 struct 字段名是Auth JWT Expiry，空格和大小写容易写错，不如扁平化成AuthJWTExpiry
多环境配置（dev/staging/prod）怎么隔离
别靠 if-else 切换配置路径，viper 原生支持 viper.SetEnvPrefix("APP") + viper.AutomaticEnv()，环境变量优先级天然高于文件。
实操建议：
- 开发时用
APP_LOG_LEVEL=debug go run main.go，生产用APP_ENV=prod触发加载config-prod.yaml - 在
viper.AddConfigPath()后立刻调用viper.SetConfigName(fmt.Sprintf("config-%s", viper.GetString("env")))，让env字段控制文件名 - 敏感配置（如数据库密码）绝不在 YAML 里明文存，走环境变量或 secrets manager；viper 会自动把
APP_DATABASE_PASSWORD映射到database.password - 测试环境禁用热重载：
if viper.GetString("env") != "dev" { viper.WatchConfig() }，避免测试跑着跑着配置突变
真正难的不是读配置，而是确保每次变更都经过验证——比如新添一个 cache.ttl 字段，得有单元测试检查它是否被正确解析为 time.Duration，而不是留在 map[string]interface{} 里等着 runtime panic。
