structtag是reflect.structtag类型，非普通字符串；必须用.get("key")安全获取，不可用strings.split或正则解析，因其内部已处理引号、转义与空格，手动解析易出错。
StructTag 是什么，为什么不能直接用 string 处理
reflect.StructTag 不是普通字符串，而是一个带解析逻辑的类型。它内部用空格分隔多个键值对，每个键值对形如 json:"name,omitempty"，但引号、逗号、等号都有语义。直接用 strings.Split 或正则硬切，会错判嵌套引号、转义、空格位置，导致解析失败或 panic。
Go 标准库已提供安全解析方式：调用 tag.Get("key")。它会完整遵循 RFC 规则（比如支持 json:"\"quoted\"" 这种带双引号转义的值）。
- 永远别手动解析
structTag字符串 —— 即使看起来“很简单” -
tag.Get("json")返回的是去引号、去空格、已解码的纯字符串值（如"name,omitempty"→name,omitempty） - 如果 key 不存在，
Get返回空字符串，不会 panic
如何从 struct 字段拿到 StructTag 并提取字段名
必须先通过 reflect.TypeOf 拿到结构体类型，再用 Field(i) 获取字段，最后取 Tag 字段 —— 注意不是 reflect.Value，而是 reflect.Type。
type User struct {
Name string `json:"name" db:"user_name"`
Age int `json:"age"`
}
t := reflect.TypeOf(User{})
field, _ := t.FieldByName("Name")
tag := field.Tag // 类型是 reflect.StructTag
jsonName := tag.Get("json") // → "name"
dbName := tag.Get("db") // → "user_name"
- 字段名大小写敏感：
field.Tag.Get("JSON")返回空，因为标签是小写的json - 如果字段是匿名嵌入（如
json:",inline"），Get仍能正确返回",inline" -
field.Tag在编译期就确定，运行时无开销；但反射本身有性能成本，别在 hot path 频繁调用
解析自定义标签时常见的错误格式和 panic 场景
StructTag 要求严格语法：每个键值对必须是 key:"value" 形式，value 必须用双引号包裹，且不能换行。以下写法都会让 reflect.StructTag 构造失败（虽然编译不报错，但运行时 tag.Get 可能返回意外结果）：
`json:name` → 缺少双引号，<code>Get("json")返回空`json:"name, omitempty"` → value 中含非法空格，<code>Get("json")返回name,（逗号后截断）`json:"name,omitempty" db:user_id` → 第二个键值对缺引号，整个 tag 解析异常，后续 <code>Get行为不可靠`json:"name\034"` → 包含非法控制字符，Go 1.21+ 会 panic：invalid character in struct tag
建议在单元测试里加一条检查：reflect.StructTag(tagStr).Get("xxx") 是否符合预期，比线上出问题再排查更早暴露问题。
如何安全支持带选项的自定义标签（如 mytag:"field,required,max=100"）
StructTag.Get 只负责取值，后续解析需你自己处理。推荐用标准库 strings.Split + strings.TrimSpace 分离选项，再用 strings.SplitN 拆键值对 —— 不要自己写状态机。
raw := tag.Get("mytag") // → "field,required,max=100"
parts := strings.Split(raw, ",")
for _, p := range parts {
p = strings.TrimSpace(p)
if strings.Contains(p, "=") {
kv := strings.SplitN(p, "=", 2)
key, val := kv[0], kv[1]
switch key {
case "max":
maxVal, _ := strconv.Atoi(val) // 注意错误处理
}
} else {
// 纯 flag，如 "required"
}
}
- 选项顺序无关，但等号前后不能有空格：
max = 100会导致val带空格，Atoi失败 - 如果选项值本身含逗号（如
pattern:"^a+,b*$"），这种简单分割就不适用，得用更健壮的 parser（比如先按双引号切块再处理） - 生产环境建议用现成库如
github.com/mitchellh/mapstructure或go-playground/validator，它们已处理了所有边界情况
真正麻烦的从来不是取标签，而是把取出来的字符串按你自己的语义稳稳拆开 —— 引号嵌套、转义、空格、等号歧义，每一种都可能在线上突然崩一次。
