结构体标签是仅供反射读取的字符串，语法错误（如引号错、空格多、逗号分隔）会导致Tag.Get()静默返回空；仅导出字段有效，omitempty按零值判断，自定义标签须用Tag.Get()安全提取。
结构体标签不是注解，不能被编译器识别或执行，它只是一段被反射读取的字符串——写错语法、用错引号、加了空格，Tag.Get() 就会静默返回空字符串，而编译器完全不报错。
为什么 json:"name" 有时不生效
常见现象：字段明明写了 json:"name"，但 json.Marshal() 输出的键名还是驼峰（如 UserName → "UserName"），或者字段直接消失。
- 字段未导出：只有首字母大写的导出字段才能被
encoding/json反射访问；userName string的 tag 永远不会被读取 - 标签用了双引号或单引号包裹：
"json:\"name\""或'json:"name"'都不是合法 tag，只是普通字符串字面量 - 冒号后多空格：
json: "name"（冒号后有空格）→field.Tag.Get("json")返回"" - 多个 tag 用逗号分隔：
`json:"name",db:"user_name"`→ 整个字符串解析失败，所有 key 均取不到
omitempty 的行为和陷阱
它不是“空就忽略”，而是“值等于该类型的零值时才忽略”——这个判断逻辑对指针、结构体、切片差异极大。
-
Name *string `json:"name,omitempty"`：仅当Name == nil才省略；若Name指向一个空字符串""，仍会输出"name": "" -
User User `json:"user,omitempty"`：结构体没有nil，User{}（全零值）仍会被序列化为"user":{} -
Tags []string `json:"tags,omitempty"`：空切片[]string{}和nil切片都会被省略 - 嵌套结构体字段带
omitempty时，外层结构体不会因内层为空而被跳过
如何安全读取自定义标签（如 filtered:"true"）
自定义标签必须靠 reflect 显式提取，且只能作用于导出字段；非导出字段的 tag 在反射中不可见。
立即学习“go语言免费学习笔记（深入）”；
- 读取前先确认字段是否导出：
field.IsExported()，否则field.Tag.Get("filtered")总是返回"" - 不要手动解析字符串：用
field.Tag.Get("key")，而不是strings.Split(field.Tag, " ")—— 后者无法处理带空格或转义引号的 value - value 中含双引号需转义：
doc:"用户姓名 \"管理员\""是合法的，但必须用Tag.Get()解析，不能硬拆 - 多个相同 key 的 tag 不会合并，
Tag.Get()只返回第一个匹配项
最易被忽略的一点：结构体标签的语法错误没有任何编译提示，它只会在运行时导致数据映射失败、校验跳过、API 字段缺失——而这些现象往往要到联调或上线后才暴露。
