必填环境变量校验必须在main()开头用os.LookupEnv集中检查，禁止在init()中校验；mapstructure需关闭WeaklyTypedInput或二次校验；第三方env库须显式处理Parse返回error。
启动时 panic 之前先检查 os.Getenv 是否为空
Go 没有内置配置校验机制，很多项目直接在 init() 或 main() 里调 os.Getenv("DB_HOST")，结果环境变量缺失时程序照常启动，直到连接数据库失败才报错——这时服务已注册到注册中心或监听了端口，问题更难定位。
正确做法是：所有必填环境变量在 main() 最开头集中读取并校验，任一为空立即 log.Fatal。不要等结构体绑定、不要等配置解析完再检查。
-
os.Getenv返回空字符串不等于变量未设置（比如export DB_PORT=""），所以不能只判== ""，得用os.LookupEnv - 把必填项列成切片，循环检查比写一堆
if os.Getenv(...) == ""更易维护 - 错误信息里明确写出缺失的 key，别只说 “config error”
func main() {
required := []string{"APP_ENV", "DB_HOST", "REDIS_URL"}
for _, key := range required {
if _, ok := os.LookupEnv(key); !ok {
log.Fatalf("missing required env: %s", key)
}
}
// 后续逻辑
}
用 mapstructure.Decode 做结构体绑定时开启 WeaklyTypedInput 要谨慎
很多人用 mapstructure 把 os.Environ() 或 YAML 解析结果转成 struct，但默认开启 WeaklyTypedInput 会导致 "false" 被转成 false、空字符串被转成零值（如 "" → 0），掩盖了本该报错的缺失字段。
必填字段校验必须发生在类型转换之前，或者关掉弱类型转换，让缺失字段直接解码失败。
立即学习“go语言免费学习笔记（深入）”；
- 显式关闭
WeaklyTypedInput: false，这样int字段若环境变量未设置，Decode会返回 error - 如果仍需弱类型（比如允许
"1"转int），那就别依赖Decode报错，自己在 struct tag 里加校验标记，再用validator库二次检查 -
mapstructure不校验 struct 字段是否为零值，它只管“能不能转”，所以DB_PORT=""会被转成0而不报错
用 env 库（如 caarlos0/env）时注意 required tag 的触发时机
第三方库如 caarlos0/env 支持 env:"DB_HOST,required" 这种 tag，但它只在校验阶段（即调用 Parse）检查，而 Parse 默认不会因 required 缺失 panic，而是返回 error——这点容易被忽略，导致写了 required 却没生效。
- 必须显式检查
env.Parse(&cfg)的 error，不能忽略返回值 - 某些版本默认把空字符串当作“已设置”，所以
export DB_HOST=""会通过required检查；如需拒绝空值，得额外加notEmpty或自定义 validator - 嵌套 struct 的
required不会自动递归校验，外层 struct 的 tag 生效，内层要单独声明
别在 init() 里读环境变量做校验
init() 函数执行顺序不可控，尤其当多个包都有 init() 且互相 import 时，可能在 main() 之前就尝试读取尚未由父进程设置好的环境变量（比如容器启动脚本还没跑完），导致误报缺失。
所有校验逻辑必须收口到 main() 开头，这是唯一能确保环境已就绪的位置。
-
init()适合做常量初始化、sync.Once 设置，不适合依赖运行时环境 - 哪怕用了
go.uber.org/zap这类日志库，也别在init()里调os.Getenv配置 logger，logger 初始化本身不该失败 - 测试时容易漏掉
init()中的校验，因为单元测试常绕过main()，建议把校验逻辑抽成独立函数，在测试中显式调用
最易被忽略的是：环境变量可能被 shell 脚本清空、被 Kubernetes ConfigMap 挂载为空文件、或被 Docker 的 --env-file 中的空行干扰——这些都不会触发 Go 的“未定义变量”错误，只会给你一个空字符串，而你的校验逻辑是否真的区分了“未设置”和“设为空”？
