go-envy无法映射环境变量到结构体字段，因其仅封装os.getenv、不支持struct tag解析；应改用envy（caarlos0/envy），它支持env tag、类型转换、默认值与必填校验。
Go-envy 无法直接映射环境变量到结构体字段
Go-envy 已经归档（archived），官方仓库明确标注不再维护，且它本身不提供“自动映射到 struct 字段”的能力——它只是个轻量级的 os.Getenv 封装，连 struct tag 解析都不支持。如果你看到示例里写了 envy.Load(&cfg) 这类调用，那基本是混淆了 go-envy 和更主流的 envy（无 go- 前缀）、koanf 或 viper。
真实情况是：go-envy 只能按 key 名查值，比如 envy.Get("DB_PORT")，返回 string，你要自己转类型、自己赋值给结构体字段。它不读 struct tag，不校验必填项，也不做默认值回退。
想用结构体绑定环境变量？改用 envy（无 go- 前缀）或 koanf
目前最轻、最贴近你需求的替代是 envy（GitHub 上 caarlos0/envy）。它支持 env tag、类型自动转换、默认值、必填校验，且无外部依赖。
import "github.com/caarlos0/envy"- 结构体字段加
env:"DB_HOST,required"或env:"DB_PORT,default=5432" - 调用
envy.Parse(&cfg)即可完成加载和校验 - 错误会直接返回，比如
env: required env DB_USER not set
示例：
type Config struct {
DBHost string `env:"DB_HOST,required"`
DBPort int `env:"DB_PORT,default=5432"`
}
var cfg Config
if err := envy.Parse(&cfg); err != nil {
log.Fatal(err) // 如 DB_HOST 未设置，这里 panic
}
为什么别硬套 go-envy 做结构体映射
有人尝试用反射 + go-envy.Get 手动遍历字段去“模拟映射”，结果踩了三个坑：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 字段必须是导出的（首字母大写），否则反射拿不到值
-
go-envy.Get返回string，但 int/bool/float 类型要自己strconv.Atoi，没做错误包装，panic 风险高 - 没有默认值机制：环境变量缺失时字段为零值（如
int是0），而你本意可能是“报错”或“用默认值”
这些逻辑在 envy 或 koanf 里已稳定封装多年，重复造轮子只会让配置初始化变成隐性故障点。
生产环境建议加一层类型安全校验
哪怕用了 envy，也别跳过运行时校验。例如 DBPort 是 int，但用户可能误设成 DB_PORT="abc" ——envy 会在此时报错，但错误信息是 strconv.ParseInt: parsing "abc": invalid syntax，不够友好。
推荐做法：在 envy.Parse 后加一个 Validate() 方法（自己写或用 go-playground/validator）：
type Config struct {
DBHost string `env:"DB_HOST,required" validate:"required,fqdn"`
DBPort int `env:"DB_PORT,default=5432" validate:"min=1,max=65535"`
}
// ...
if err := envy.Parse(&cfg); err != nil { /* handle */ }
if err := validator.New().Struct(cfg); err != nil { /* better error */ }
真正容易被忽略的是：环境变量名大小写敏感，且不同 shell 对空格、引号处理不一致。本地测试用 export DB_HOST=localhost 没问题，CI 环境如果写成 DB_HOST = localhost（带空格），go-envy.Get 就会返回空字符串，而 envy 的 required 标签能立刻暴露这个问题。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
