structtag.lookup 返回空字符串的常见原因是 tag 格式不合法：key-value 必须用空格分隔，value 必须用双引号包裹，单引号、无引号、引号内含未转义换行或逗号后带空格均会导致解析失败。
StructTag.Lookup 返回空字符串的常见原因
调用 reflect.StructTag.Lookup 却拿不到值？大概率是 tag 字符串格式不合法，不是结构体字段没写 tag，而是 Go 的解析器直接跳过了它。StructTag 要求每个 key-value 对必须用空格分隔，且 value 必须用双引号包裹（"），单引号、不带引号、或引号内含未转义换行都会导致整个 tag 被视为无效，Lookup 返回空字符串。
- ✅ 正确：
`json:"name" db:"user_name"` - ❌ 错误：
`json:name db:user_name`（缺引号） - ❌ 错误：
`json:'name'`（单引号） - ❌ 错误：
`json:"name" db: user_name`（db:后多空格且无引号）
用 reflect.StructTag.Get 替代 Lookup 更安全
Lookup 只返回 value，不告诉你这个 key 是否真实存在；而 Get 在 key 不存在时返回空字符串，行为一致，但语义更清晰——它本就是为“尝试获取”设计的。更重要的是，如果你需要同时读多个 tag（比如先查 json， fallback 到 xml），直接连用 Get 更自然，不用反复判断 ok。
-
tag.Get("json")和tag.Lookup("json")在绝大多数场景下效果相同 - 若需严格区分“key 不存在”和“value 为空字符串”，才必须用
Lookup+ok判断 - Go 标准库自身（如
encoding/json）也优先用Get
嵌套结构体中 tag 解析容易漏掉 reflect.TypeOf().Elem()
定义了一个指针型字段（如 *User），想取其内部字段的 tag？别直接对 field.Type 调 reflect.StructTag —— 那只是 *User 的类型，不是 User 结构体。必须先确认是否为指针/接口/切片等间接类型，并用 .Elem() 层层解包，直到拿到 reflect.Struct。
- 错误写法：
field.Type.Field(0).Tag.Get("json")（field.Type是*User，没有Field方法） - 正确路径：
reflect.TypeOf(&User{}).Elem().Field(0).Tag.Get("json") - 通用解法：写个 helper 函数递归调用
.Elem()，直到Kind() == reflect.Struct
StructTag 值里含逗号或空格时必须转义
想在 tag value 中存多个参数（比如 db:"name,primary_key"），没问题；但如果你写了 db:"name, primary_key"（逗号后带空格），StructTag 会把它当两个独立 key 处理，后续 Lookup("db") 就失效了。Go 的 tag 解析器把空格当作 key 分隔符，不识别引号内空格。
立即学习“go语言免费学习笔记（深入）”；
- ✅ 安全：
`db:"name,primary_key"`、`validate:"required,max=100"` - ❌ 危险：
`db:"name, primary_key"`（空格导致解析中断） - 如果真要存带空格的值（极少见），只能换分隔符，比如用竖线：
`search:"full|text|index"`
StructTag 看似简单，但格式容错率极低；一个引号、一个空格、一层指针没解包，就静默失败。调试时别只盯代码逻辑，先用 fmt.Printf("%q", field.Tag) 看原始字符串长什么样。