正确做法是动态拼接环境后缀：viper.setconfigname("config-" + os.getenv("env"))，并配套调用addconfigpath、setconfigtype，配合setenvkeyreplacer和setenvprefix处理点号与前缀映射，敏感字段仅从环境变量读取。
viper.SetConfigName 必须动态拼接环境后缀
硬编码 viper.SetConfigName("config-prod") 是最常见错误，会导致 dev 环境启动时直接报 Config File Not Found。viper 不会自动识别 ENV=dev 并补全文件名，它只按你设置的 SetConfigName 去找文件。
正确做法是在 viper.ReadInConfig() 之前，用环境变量拼出完整基名：
-
viper.SetConfigName("config-" + os.Getenv("ENV"))（推荐小写ENV） - 必须配套调用
viper.AddConfigPath("./configs")，路径要真实存在且可读 - 必须在
ReadInConfig()前调viper.SetConfigType("yaml")，否则可能报Unsupported Config Type "" - 确保启动前已设好环境变量，例如
ENV=dev go run main.go或 Docker 中用-e ENV=prod
环境变量与配置字段名不匹配怎么办
viper.AutomaticEnv() 默认只做全字符串匹配，server.port 会去找名为 SERVER.PORT 的环境变量，但系统里实际是 SERVER_PORT —— 这个点号不转下划线，永远拿不到值。
解决方法分两步：
- 尽早调
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))，让结构体路径自动映射为下划线命名 - 加统一前缀避免冲突：
viper.SetEnvPrefix("app")，这样app.server.port对应APP_SERVER_PORT - 特殊字段需显式绑定：
viper.BindEnv("db.host", "PGHOST")，适用于PGHOST→db.host这类非标准映射
嵌套结构体 unmarshal 后字段为空的真正原因
不是 viper “没读到”，而是它严格依赖 struct tag。它不会推导字段名、不转换大小写、也不自动把 host 映射成 Host。
检查这三点：
- 字段必须是导出的（首字母大写），否则
yaml.Unmarshal无法写入 - 必须显式声明
yaml:"host"tag，且内容与 YAML 文件中 key 完全一致（大小写敏感） - 如果用了嵌套结构，外层也要有 tag，例如
Server ServerConfig `yaml:"server"`，不能只写内层
os.Getenv(".env 文件") 为什么总返回空
Go 本身不解析 .env 文件，os.Getenv 只读操作系统级环境变量。你写了 os.Getenv("DB_URL") 却没加载 .env，自然为空。
必须在 main() 最开头调用：
-
godotenv.Load()（默认读当前工作目录下的.env） - 多环境时显式指定：
godotenv.Load(".env." + os.Getenv("ENV")) - 注意：CI/CD 中执行路径可能不是源码目录，建议用绝对路径或提前
cd - 测试中别用
os.Setenv模拟——它不覆盖已由godotenv.Load()加载的变量，且并发测试会互相污染
最易被忽略的是：viper 的优先级链（flag > env > file > default）只有在所有加载步骤都正确触发的前提下才生效；任意一环缺失（比如忘了 SetConfigType 或 SetEnvKeyReplacer），就会静默退化成低优先级行为，问题往往藏得深、难复现。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
