config目录未被viper找到，是因为viper默认仅在当前工作目录（os.Getwd()）搜索，不递归子目录；必须在ReadInConfig()前显式调用AddConfigPath("./config")指定路径，且可多次调用以支持多路径fallback。
config 目录没被 viper 找到？先检查 AddConfigPath
viper 默认只在当前工作目录（os.Getwd() 返回的路径）下搜索配置文件，不会递归子目录。你把 config.yaml 放在 ./config/ 里，但没调用 viper.AddConfigPath("./config")，它就永远找不到。
- 必须在
viper.ReadInConfig()之前调用viper.AddConfigPath()，顺序错了会报Unsupported Config Type "" - 可以多次调用
AddConfigPath添加多个路径，比如先加"./config"，再加"/etc/myapp"作 fallback - GoLand 运行时的当前工作目录默认是项目根目录，不是
cmd/xxx子目录——这点容易误判，建议在main()开头加log.Println("wd:", os.Getwd())确认
ENV=prod 时 config.prod.yaml 不生效？别手动拼文件名
写 if env == "prod" { viper.SetConfigName("config.prod") } 是脆弱做法：漏掉 staging、大小写不一致、环境变量为空时 panic 都可能发生。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 统一用
viper.SetEnvPrefix("APP")+viper.AutomaticEnv()，让APP_HTTP_PORT自动覆盖http.port - 环境专属文件靠
viper.MergeInConfig()加载，而不是重设SetConfigName后再ReadInConfig——后者会清空已加载内容 - 推荐结构：
./config/config.yaml（通用）+./config/config.prod.yaml（覆盖），启动时先ReadInConfig()，再根据os.Getenv("APP_ENV")调用MergeInConfig()
敏感字段（如 db.dsn）写进 YAML 就等于泄露？必须隔离
Git 提交 config.prod.yaml 里明文写 db.dsn: root:pass@prod-db:3306/...，等于把生产密码放进仓库——CI/CD 流水线一跑就全暴露。
- YAML 文件只存非敏感、可版本化的字段：超时时间、重试次数、开关标志（
feature.enable_caching: true） - 所有敏感项（
database.dsn、redis.addr、jwt.secret）强制通过环境变量注入，且命名带前缀，如APP_DATABASE_DSN - 启动时做硬校验：
if os.Getenv("APP_ENV") == "prod" && strings.Contains(os.Getenv("APP_DATABASE_DSN"), "localhost") { log.Fatal("prod DB points to localhost") }
WatchConfig 热更新后结构体字段还是旧值？Unmarshal 没重做
viper.WatchConfig() 只触发回调，不会自动刷新你已 Unmarshal 过的结构体变量。常见错误是监听了变更，但业务代码仍用初始化时解析的老对象。
- 必须在
viper.OnConfigChange回调里重新调用viper.Unmarshal(&cfg)，否则字段值永远不变 - 如果结构体里有指针字段（如
*string），Unmarshal会跳过未设置字段——改用零值默认初始化更可靠 - 热更新期间可能读到半新半旧状态，对关键配置（如限流阈值）建议加读写锁或原子替换指针
