Go结构体标签需用反引号包裹，key-value用空格分隔，value用双引号并转义内部引号；必须用reflect.StructTag.Get提取，再手动解析如json标签的字段名和选项；访问字段值前须检查field.CanInterface()避免panic；高频场景应缓存解析结果。
结构体标签怎么写才被 reflect 正确读取
Go 的结构体标签（struct tag）本质是字符串，reflect.StructField.Tag 返回的是原始字符串，不会自动解析。必须用 reflect.StructTag.Get 方法按 key 提取值，否则拿到的是整个未处理的字符串，比如 `json:"name,omitempty" db:"user_name"`，直接打印会看到完整内容，不是你想要的 name。
常见错误是把标签当 map 用，或手动字符串切分——这既不可靠（空格、引号、逗号都可能破坏格式），也绕过了 Go 标准库对结构化标签的校验逻辑。
- 标签必须用反引号
`包裹，不能用双引号或单引号 - 每个 key-value 对之间用空格分隔，key 后紧跟冒号和带引号的 value（双引号或反引号均可，但双引号更通用）
- value 中若含双引号，需转义为
\"；若用反引号则内部双引号无需转义，但反引号本身不能嵌套 -
reflect.StructTag.Get("json")返回的是"name,omitempty"这个字符串，不是结构体字段名，后续还需自己解析这个值
如何安全解析 json 标签里的字段名和选项
json 标签值如 "id,omitempty,string" 是逗号分隔的修饰符组合，Go 标准库在 encoding/json 内部用私有函数解析它，但对外不暴露。你需要自己拆解，且必须考虑边界情况：空字段名、只有选项、带空格的选项等。
推荐做法是复用 encoding/json 的逻辑——它实际调用了 strings.TrimSpace 和 strings.Split，但更关键的是先提取第一个非空字段名部分，再处理后续选项。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用
strings.SplitN(tagValue, ",", 2)拆成最多两段：第一段是字段名（可能为空或含引号），第二段是选项（可选） - 字段名部分用
strings.Trim去掉首尾双引号或反引号，再判断是否为空；为空时默认回退到结构体字段名 - 选项部分用
strings.Split按逗号分割后，逐个比对"omitempty"、"string"等已知标识符，注意大小写敏感 - 不要依赖正则匹配字段名，因为合法 JSON 字段名可以是任意 Unicode（只要加引号），而 Go 标签解析器只认 ASCII 格式化规则
自定义标签映射时，为什么 reflect.Value.Interface() 容易 panic
反射访问字段值时，如果字段是未导出（小写开头），reflect.Value.Interface() 会直接 panic：“cannot interface with unexported field”。这不是标签问题，而是 Go 反射的访问控制机制在起作用——标签只是元数据，真正读值时才触发权限检查。
这意味着：即使你成功从标签里提取出 db:"user_id"，也不能保证能读到对应字段的值。必须先确认字段是否可寻址（v.CanInterface()）且可获取（v.CanAddr() 通常不够，得看 v.CanInterface() 返回 true）。
- 遍历结构体字段时，用
field := v.Field(i); if !field.CanInterface() { continue }跳过私有字段 - 如果目标是序列化/映射到 map，建议统一用指针接收结构体，再用
reflect.Indirect()解引用，避免 nil 指针 panic - 对嵌套结构体，递归前要检查
field.Kind() == reflect.Struct且field.CanInterface()，否则深层字段访问会失败 - 别在反射循环里直接调用
field.Interface()，先用field.Kind()分支判断类型，再用field.Int()、field.String()等专用方法取值更安全
性能关键点：标签解析要不要缓存
每次反射都要重新解析标签字符串，开销不小。尤其在高频序列化场景（如 HTTP handler 中反复 encode 结构体），重复调用 reflect.TypeOf().Field(i).Tag.Get("json") 和后续字符串操作会成为瓶颈。
缓存结构体类型到字段映射关系是有效优化手段，但要注意：缓存键必须是 reflect.Type，不能用 interface{} 或字符串名，因为同名但不同包的结构体类型是不同的；缓存值建议用 struct 或 slice，避免 map 查找额外开销。
- 用
sync.Map存储reflect.Type → []fieldInfo，其中fieldInfo包含解析好的 JSON 名、DB 名、是否 omitempty 等字段 - 首次访问某类型时解析一次，之后全部走缓存；注意
reflect.Type是可比较的，适合做 map key - 不要缓存
reflect.Value，它包含运行时状态，不能跨调用复用；只缓存类型层面的元信息 - 如果项目用到了 go:generate 或 codegen（如 sqlc、ent），其实更适合在编译期生成映射代码，彻底避开运行时反射
标签解析本身不复杂，但组合反射访问、类型检查、缓存策略之后，容易在 nil 指针、私有字段、嵌套结构体这几处掉坑里。最常被忽略的是：没验证字段是否可导出就调 Interface()，或者以为标签解析完就能直接用，忘了 value 还要按类型分别取值。
