为什么 Viper 读不到环境变量？
不是 Viper 不支持，而是默认不自动绑定——它不会主动把 os.Getenv 的结果映射到配置键上，必须显式调用 BindEnv 或启用 AutomaticEnv。
常见错误现象：Viper.GetString("db.host") 返回空字符串，但 os.Getenv("DB_HOST") 能取到值；或者本地 .env 文件生效了，但部署到 Kubernetes 里环境变量却失效。
- 使用场景：CI/CD 注入环境变量、Docker 容器启动时传参、K8s
envFrom配置 - 推荐做法：调用
viper.AutomaticEnv()后，再用viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))把db.host映射为DB_HOST - 注意
AutomaticEnv只对后续的Get*生效，不能回溯已加载的文件配置；如果文件里已有db.host，它会优先用文件值，除非你调用viper.SetDefault并确保没被覆盖
Viper 加载顺序怎么影响最终配置？
配置来源有优先级：环境变量 > 命令行参数 > 文件（按 AddConfigPath 顺序逆序） > 默认值。这个顺序不能改，但容易误以为“后加的文件会覆盖前面的”。
实际行为是：Viper 按添加路径的**逆序**扫描文件，找到第一个匹配的就停；比如 AddConfigPath("/etc/myapp") 和 AddConfigPath("$HOME/.myapp")，它先查 $HOME/.myapp，再查 /etc/myapp，所以用户目录的配置反而优先级更高。
立即学习“go语言免费学习笔记（深入）”；
- 典型坑：本地开发用
config.yaml，上线想用/etc/myapp/config.yaml，结果因为路径添加顺序不对，还是读到了用户目录下的旧配置 - 建议统一用
viper.AddConfigPath添加所有可能路径，然后只调一次viper.ReadInConfig()，别手动多次ReadConfig - 调试时用
viper.AllSettings()打印全部键值，确认哪些被环境变量覆盖、哪些来自哪个文件
如何安全地让 Viper 支持 .env 文件？
Viper 本身不解析 .env，需要靠 viper.SetConfigType("env") + viper.ReadConfig 配合 os.Open 手动加载，但这只是把文件当纯文本读，不等价于 godotenv 的变量展开逻辑（比如 PORT=${HTTP_PORT} 不会替换）。
- 正确姿势：先用
github.com/joho/godotenv.Load(".env")加载进os.Environ()，再调viper.AutomaticEnv()—— 这样环境变量层面就完成了注入 - 不要在
main()开头就Load，否则测试时并发跑多个go test会互相污染环境变量；建议封装成函数，在初始化 Viper 前按需调用 - 生产环境禁用
.env：通过构建 tag（如//go:build !prod）控制是否加载，避免敏感信息意外提交或泄露
Web 服务启动时怎么验证配置不缺失？
很多 panic 是因为 viper.GetString("redis.addr") 返回空，但代码直接传给 redis.Dial 导致连接失败——这不是运行时错误，而是配置缺失的逻辑错误。
- 推荐在
main()初始化完 Viper 后，集中校验关键字段：if viper.GetString("http.addr") == "" { log.Fatal("missing HTTP_ADDR") } - 避免每个模块自己去
GetString：定义一个type Config struct，用viper.Unmarshal(&cfg)一次性绑定，再对结构体字段做非空/格式检查（比如用net.ParseIP验证 IP） - 注意
Unmarshal不会触发环境变量绑定逻辑，它只从当前已合并的配置快照中取值；所以务必在AutomaticEnv和ReadInConfig之后再调用
环境变量和 Viper 的耦合点其实就三个动作：绑定、加载、取值。中间漏掉任意一个，配置就变成“看似配了，实则没用”。最常被忽略的是 SetEnvKeyReplacer —— 没它，database.url 根本对应不上 DATABASE_URL。
