reflect.StructTag解析失败导致字段为空，主因是未用field.Tag.Get("env")而误用其他tag名、字段未导出、未处理嵌套struct及类型转换异常。
为什么 reflect.StructTag 解析失败导致字段始终为空
常见现象是结构体字段没被赋值，哪怕环境变量明明存在。根本原因在于：Go 反射无法自动识别自定义 tag 名称，必须显式调用 field.Tag.Get("env") 而不是默认读 json 或忽略 tag。如果 tag 写成 `env:"DB_HOST"` 却用 field.Tag.Get("json") 去取，结果就是空字符串。
- 务必确认 struct 字段 tag 使用统一前缀，比如
env，且拼写完全一致（区分大小写） - 字段必须是导出的（首字母大写），否则
reflect根本访问不到 - 嵌套 struct 不会自动递归解析，需手动判断
field.Type.Kind() == reflect.Struct并进入下一层 - 别依赖
os.Getenv的返回值非空来判断字段是否应设置——有些 env 变量可能设为空字符串，这也是合法值
如何安全地把 os.Getenv 字符串转成目标字段类型
反射本身不提供类型转换逻辑，SetString、SetInt 等方法只接受已转换好的值。直接用 strconv 硬转容易 panic，比如把 "true" 丢给 int 字段。
- 先用
field.Type.Kind()判断基础类型：如reflect.String、reflect.Int、reflect.Bool、reflect.Float64 - 对
Bool，优先检查值是否为"1"、"t"、"T"、"true"、"TRUE"（strconv.ParseBool只认小写 true/false） - 对
Int类型，统一用strconv.ParseInt(val, 10, 64)，再通过field.SetInt()设置，避免溢出时静默截断 - 对指针字段（如
*string），需先field.Set(reflect.New(field.Type.Elem()))，再对其Elem()赋值
os.LookupEnv 比 os.Getenv 更适合配置加载的三个理由
用 os.Getenv 读不到变量时只会返回空字符串，你无法区分“变量未设置”和“变量设为空”。这在配置校验阶段非常致命。
-
os.LookupEnv(key)返回value string, ok bool，能明确知道变量是否存在 - 可据此实现“必填字段校验”：若 tag 含
required:"true"且ok == false，直接报错退出 - 配合
default:"xxx"tag，仅当ok == false时才回退到默认值，避免覆盖用户显式设为空的意图
嵌套 struct 和 slice 字段的环境变量命名怎么设计才不踩坑
环境变量天然扁平，而 Go struct 可能多层嵌套。硬编码路径（如 DB_URL 对应 Config.DB.URL）看似直观，但一加层级就爆炸式增长。
立即学习“go语言免费学习笔记（深入）”；
- 推荐用双下划线
__分隔层级，例如DB__HOST→Config.DB.Host，比单下划线更不易与字段名冲突 - slice 字段（如
[]string）用逗号分隔值：ALLOWED_ORIGINS="http://a.com,https://b.net"，注意 trim 空格 - 避免在 struct 中混用
map[string]string和环境变量映射——map 无法从扁平 key 推导出键名，建议全量用 struct 表达配置树 - 如果真要支持 map，约定格式如
HEADERS__CONTENT_TYPE="application/json"，解析时按__切分后取最后一段作 map key
