reflect.StructTag.Get 返回空字符串是因为标签信息仅存在于Type而非Value中，必须通过reflect.TypeOf获取类型后遍历字段调用Tag.Get，且tag格式需严格符合反引号包裹、键名小写、无非法空格等要求。
为什么 reflect.StructTag.Get 返回空字符串？
结构体字段的标签（tag）不是自动可读的，必须先通过 reflect.TypeOf 获取类型，再用 Field 拿到字段，最后调用 Tag.Get("key") —— 少任何一个环节都会返回空。常见错误是直接对结构体实例用 reflect.ValueOf 后试图读 tag，但 Value 不包含 tag 信息，只有 Type 有。
正确路径是：reflect.TypeOf(struct{}).Elem().Field(i).Tag.Get("json")（如果是指针）或 reflect.TypeOf(struct{}).Field(i).Tag.Get("json")（直传值）。
- 如果结构体是匿名嵌入，需遍历所有字段并检查
Anonymous字段属性 - tag 值必须用反引号包裹，且键名区分大小写：
`json:"name"`中用Tag.Get("json")，不能写"JSON" - 空格和双引号不合法：`json: "name"`（带空格）会导致解析失败，
Get返回空
如何安全地批量提取结构体所有 json 标签并映射字段名？
手动遍历每个字段容易漏掉嵌套、忽略导出性限制（非导出字段无法被 reflect 访问），建议封装一个通用函数，只处理导出字段，并跳过未设置对应 tag 的字段。
func GetJSONTags(v interface{}) map[string]string {
t := reflect.TypeOf(v)
if t.Kind() == reflect.Ptr {
t = t.Elem()
}
out := make(map[string]string)
for i := 0; i < t.NumField(); i++ {
f := t.Field(i)
if !f.IsExported() {
continue
}
jsonTag := f.Tag.Get("json")
if jsonTag == "" || jsonTag == "-" {
continue
}
name := strings.Split(jsonTag, ",")[0] // 忽略 omitempty 等选项
if name == "" {
name = f.Name
}
out[f.Name] = name
}
return out
}
- 注意判断
f.IsExported()，否则 panic：“cannot set unexported field” 类似错误其实常源于读取阶段就该过滤 -
jsonTag == "-"表示显式忽略，必须排除，否则会把字段映射成空 key - 使用
strings.Split(jsonTag, ",")[0]是为了兼容json:"user_id,omitempty"这类带选项的写法
reflect.StructTag 解析失败的典型报错和修复方式
最常见的错误是 panic: reflect: Field tag not compatible with struct 或静默返回空 —— 实际上不是 panic，而是你调用了 Tag.Get 但 tag 字符串本身格式非法。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 错误写法：
`json:"name, string"`（逗号后多空格）→ Go tag parser 会截断，Get("json")返回"name"，但后续解析可能出错 - 更隐蔽的是 UTF-8 BOM 或不可见控制字符混入 tag 字符串（尤其从模板或配置生成代码时），可用
fmt.Printf("%q", tag)查看真实字节 - 反射无法识别自定义语法糖，例如
`db:"user_name" validate:"required"`是合法的，但Tag.Get("validate")和Tag.Get("db")必须分开调，不能合并解析
性能敏感场景下要不要用反射读标签？
要，但别在热路径反复做 reflect.TypeOf + 遍历。结构体类型固定时，标签内容不会变，应缓存解析结果。
- 用
sync.Map或map[reflect.Type]*fieldMeta缓存字段名与 tag 映射，首次访问构建，后续直接查表 - 避免在 HTTP handler 内每次请求都调
GetJSONTags(req.Body)，应提前为已知结构体类型生成转换器 - 如果项目中大量依赖 tag 映射（如 ORM、序列化库），考虑用
go:generate+ast包在编译期生成静态代码，绕过运行时反射开销
最易被忽略的一点：反射读 tag 本身不慢，慢的是反复创建 reflect.Type 和遍历字段；而真正危险的是误把非导出字段当导出字段处理，导致运行时 panic 却没在测试中暴露。
