配置文件不存在时 viper.ReadInConfig() 会静默失败？
不会静默失败，但默认行为容易让人误以为“没报错就成功了”——viper.ReadInConfig() 在找不到任何匹配配置文件时，**只返回 nil 错误**，而它内部其实已跳过所有候选路径。真正的问题是：你没检查 viper.ConfigFileUsed() 是否为空。
- 必须在
viper.ReadInConfig()后立刻检查：if viper.ConfigFileUsed() == "" { log.Fatal("no config file loaded") } - 别依赖
err != nil判断加载失败；Viper 对“没找到文件”不视为错误，而是“无配置”，这是设计使然 - 如果想强制要求配置存在，手动补一层校验，比如：
if _, err := os.Stat(viper.ConfigFileUsed()); os.IsNotExist(err) { ... }
viper.Unmarshal() 解析结构体时字段零值被忽略？
不是被忽略，是 Viper 默认**不覆盖已设置的零值**（比如 ""、0、false），尤其当结构体字段已有初始值或之前用 viper.Set() 设过值时，Unmarshal() 不会重写它们。
- 典型现象：YAML 里写了
timeout: 30，但结构体字段Timeout int `mapstructure:"timeout"`值仍是 0 - 原因可能是该字段已被显式设为 0（比如初始化时写了
cfg := Config{Timeout: 0}），而Unmarshal()默认不覆盖 - 解决方法：调用
viper.SetDefault()预设合理默认值，再调用Unmarshal()；或改用viper.UnmarshalExact()，它会严格按配置键匹配，且对缺失字段报错 - 注意
mapstructure标签里的default不生效，Viper 不读取 struct tag 的 default
环境变量覆盖配置时大小写敏感导致 viper.Get() 拿不到值？
Viper 默认把环境变量名转成全大写 + 下划线（APP_TIMEOUT → app.timeout），但如果你的结构体字段是 Timeout，对应 key 是 timeout，而环境变量写成 APP_timeout 或 app_timeout 就无法命中。
- 环境变量前缀必须全大写，且用下划线分隔，例如：
viper.SetEnvPrefix("APP")+viper.AutomaticEnv()要求变量名为APP_LOG_LEVEL - 字段映射靠的是 key 名（非字段名），所以
type Config struct { LogLevel string `mapstructure:"log_level"` }才能响应APP_LOG_LEVEL - 调试技巧：打印
viper.AllKeys()和viper.Get("log_level")，确认 key 是否存在；再用viper.GetEnvVars()看哪些环境变量被识别了
热重载配置时 viper.WatchConfig() 不触发回调？
常见原因是没调用 viper.OnConfigChange() 注册回调，或者配置文件路径没被 inotify 监控到（比如挂载卷、NFS、容器 tmpfs）。
立即学习“go语言免费学习笔记（深入）”；
- 必须先注册：
viper.OnConfigChange(func(e fsnotify.Event) { log.Println("config changed:", e.Name) })，再调用viper.WatchConfig() - Watch 仅支持本地文件系统，Docker 中若配置挂载到
/config/app.yaml，确保该路径可被 inotify 监控（某些精简镜像如alpine缺少 inotify 支持） - 修改文件后需完整保存（write+close），用
echo "new: true" >> config.yaml追加不会触发，因为没重写 inode - Watch 不递归子目录，也不监听文件重命名；若用编辑器（如 VS Code）保存，可能先写临时文件再 mv，导致事件丢失 —— 建议用
vim -u NONE或直接cp替换测试
