最稳路径是GO_ENV冻结+YAML分文件+os.LookupEnv显式校验；GO_ENV须main首行读取并限定dev/test/prod，路径固定为./configs/config.<env>.yaml，敏感字段YAML留空、环境变量覆盖且强制非空校验。
直接用 GO_ENV 冻结环境标识 + 结构化 YAML 分文件管理 + os.LookupEnv 显式校验，是防止配置丢失最稳的路径。别信“本地跑通就行”，Docker 启动失败、K8s Pod 无限 CrashLoopBackOff，八成是配置没传进去或被静默覆盖了。
GO_ENV 必须在 main 第一行读取并冻结
一旦其他包（比如 pkg/config）提前调用 os.Getenv("GO_ENV")，就可能拿到空值或旧值——尤其在测试或 init 阶段，GO_ENV 还没被 shell 注入进来。
- 正确姿势：在
main.go开头第一行写env := os.Getenv("GO_ENV")，然后立刻做枚举校验：if env != "dev" && env != "test" && env != "prod" { panic("invalid GO_ENV") } - 后续所有逻辑（包括 config 加载、日志级别、中间件开关）都基于这个
env变量分支，不再重复查环境变量 - 禁止在
init()函数里读GO_ENV，init 执行顺序不可控，极易踩坑
YAML 文件路径硬编码 + 多环境分离
路径写死为 ./configs/config.<env>.yaml</env>，不拼接、不 fallback、不猜文件名。CI 构建时就能验证 config.prod.yaml 是否存在且语法合法，而不是等容器启动才报 “no such file”。
- 开发时只放
config.dev.yaml，内容可精简（如server.port: 8080），但结构必须和 prod 一致 - 敏感字段（如
database.dsn）在 YAML 中留空：dsn: ""，靠环境变量注入，避免误提交 - 禁止出现
config.development.yaml和config.dev.yaml混用；统一用dev/test/prod，大小写也固定小写
用 os.LookupEnv 替代 os.Getenv 做覆盖校验
os.Getenv 返回空字符串不报错，os.LookupEnv 能明确告诉你变量压根没设——这是发现配置丢失的第一道防线。
Golang Samber Hot
下载
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
立即学习“go语言免费学习笔记（深入）”；
- 对每个需环境变量覆盖的字段，显式检查：
if dsn, ok := os.LookupEnv("DATABASE_DSN"); !ok || dsn == "" { panic("DATABASE_DSN required") } - 绑定时用
viper.BindEnv("database.dsn", "DATABASE_DSN")，不是viper.AutomaticEnv()—— 后者会把所有DB_*全映射过去，拼错一个就静默失效 - 本地开发用
godotenv.Load(".env.local")，但 CI/CD 禁用.env*加载，强制走真实环境变量，防密钥漏进镜像
Docker/K8s 注入时绕不开的三个细节
配置没丢，但容器里读不到，往往卡在这三处。
- Docker run 时加
-e GO_ENV=prod，不能只写GO_ENV=prod（bash 变量未导出） - K8s ConfigMap 挂载 YAML 文件时，确保 key 名和文件内结构完全匹配（
database.host对应 YAML 里的database:\n host:），缩进和大小写全敏感 - 多层嵌套结构体字段必须导出（首字母大写），且
yaml:"host"tag 与 YAML key 严格一致，否则yaml.Unmarshal直接跳过该字段
最易被忽略的是：YAML 字段留空后，代码里没做非空校验，导致运行时 panic 报 “nil pointer” 而不是 “missing DATABASE_DSN”。配置安全迁移，本质是把“不确定”变成“确定失败”，早炸比晚炸强。
