Viper 默认不读取 .env 文件，需先用 godotenv.Load() 加载到系统环境，再调用 viper.AutomaticEnv() 才能读取；顺序错误或前缀/命名不匹配会导致 viper.Get() 返回空值。
为什么 Viper 读不到 .env 文件里的变量
Viper 默认不加载 .env 文件，它只认自己支持的配置源（如 YAML、JSON、TOML），.env 是第三方格式，必须手动桥接。常见现象是调用 viper.Get("DB_HOST") 返回空值，但确认 .env 里写了 DB_HOST=localhost。
正确做法是先用 godotenv 加载到系统环境，再让 Viper 从 os.Environ() 读取：
import (
"os"
"github.com/spf13/viper"
"github.com/joho/godotenv"
)
func init() {
// 先加载 .env 到 os.Getenv()
godotenv.Load() // 默认读当前目录下的 .env
// 再让 Viper 自动映射环境变量（注意：需开启自动映射）
viper.AutomaticEnv()
// 可选：设置前缀，避免污染全局命名空间
viper.SetEnvPrefix("APP")
}
-
godotenv.Load()必须在viper.AutomaticEnv()之前执行，否则 Viper 看不到新变量 - 如果
.env不在根目录，传路径：godotenv.Load(".config/.env") -
viper.AutomaticEnv()不会自动加前缀；设了SetEnvPrefix("APP")后，APP_DB_HOST才映射到DB_HOST
如何让 Viper 优先使用 .env 而不是配置文件
Viper 的读取顺序是“后注册的优先级更高”，所以要把 .env 对应的环境变量加载逻辑放在最后一步，才能覆盖前面加载的 YAML/JSON 配置。
典型错误是先 viper.ReadInConfig()，再 viper.AutomaticEnv()，结果配置文件值永远赢——因为 Viper 默认把环境变量当 fallback，不是 override。
- 删掉
viper.ReadInConfig()，改用纯环境驱动：只靠godotenv.Load()+viper.AutomaticEnv() - 若必须混合使用（比如默认用 YAML，允许
.env覆盖），调用顺序必须是：ReadInConfig()→godotenv.Load()→viper.AutomaticEnv() - 启用
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))，把server.port映射为SERVER_PORT，否则点号键名无法命中
viper.Get() 返回空时，怎么快速定位是哪层漏了
不是所有变量都会被 Viper “看到”：可能没加载 .env，可能前缀不匹配，也可能键名大小写或分隔符对不上。最直接的排查方式是打印 Viper 当前已知的所有键和来源：
// 打印所有已解析的键（含来源标记）
for _, k := range viper.AllKeys() {
fmt.Printf("%s = %v (from: %s)\n",
k,
viper.Get(k),
viper.GetEnvKey(k)) // 显示对应环境变量名
}
- 如果某键没出现在
AllKeys()列表里，说明它根本没被注册进 Viper，检查AutomaticEnv()是否调用、前缀是否设错 - 如果键存在但值为空，看
GetEnvKey(k)输出的环境变量名是否真存在于os.Environ()中（可用os.Getenv("XXX")单独验证） - Linux/macOS 下环境变量名全大写，Windows 不敏感但 Go 运行时统一转大写，别在
.env里写小写键名还指望它生效
生产环境部署时 .env 文件该不该提交到 Git
不该。Viper 和 .env 本身不解决密钥安全问题，只是加载手段。把数据库密码、API Key 放进 .env 并提交，等于裸奔。
- 开发时用
.env提高便利性，但加.gitignore规则：.env、.env.local、*.env - CI/CD 中用平台原生机制注入环境变量（GitHub Secrets、GitLab CI Variables、K8s ConfigMap），然后靠
viper.AutomaticEnv()直接读取 - 如果非要用文件（比如容器内挂载），改用只读配置卷 + 严格权限（
chmod 600），且文件名避开.env这种易被误提交的命名
真正麻烦的从来不是“怎么读”，而是“谁有权限写、谁有权限看、什么时候该清掉”。Viper 不管这些，它只忠实地返回你喂给它的内容。
