Go的struct tag必须严格遵循key:"value"格式，反引号包裹、英文冒号分隔、双引号包值；错误格式会被静默忽略，且私有字段无法通过tag绕过导出限制。
struct tag 写错格式就完全失效
Go 的 struct tag 不是注释，也不是任意字符串，必须严格遵循 `key:"value"` 格式：反引号包裹、键值对用英文冒号、值用双引号（不能单引号或不加引号）。常见错误是写成 `json:name` 或 `json:"name"` 少了空格或引号——这种 tag 会被编译器静默忽略，reflect.StructTag.Get("json") 返回空字符串，调试时极难发现。
- 值里含空格、逗号、等号时，必须用双引号包住，比如
`json:"user_name,omitempty"` - 多个 tag 之间用空格分隔，不是逗号，
`json:"id" db:"id"`✅，`json:"id", db:"id"`❌ - tag 值里想写双引号？得转义：
`json:"\"quoted\""`
json.Marshal 默认忽略未导出字段，tag 改不了这点
哪怕给私有字段（首字母小写）加上 json:"xxx"，json.Marshal 依然不会序列化它。这是 Go 的反射规则决定的：reflect.Value.CanInterface() 对私有字段返回 false，标准库直接跳过。别试图靠 tag 绕过导出规则。
- 要序列化内部状态，只能改字段名首字母大写（导出），再配合 tag 控制 key 名
- 如果真不能导出，就得手写
MarshalJSON()方法，自己处理字段逻辑 - 注意：
json:",omitempty"只在字段导出的前提下生效；对私有字段，这个 tag 根本没机会被读到
自定义 tag 解析容易漏掉结构体嵌套场景
用 reflect.StructTag.Get("xxx") 取 tag 时，只作用于当前字段。如果 struct 嵌套了另一个 struct，而你想递归提取所有 validate:"required"，就得手动遍历每层字段，不能只查顶层。
- 嵌入字段（anonymous field）的 tag 也会被继承，但需显式调用
field.Type.Field(i)才能拿到其内部字段 tag - 遇到指针类型（如
*User），先用Elem()解引用，再取字段；否则NumField()返回 0 - 切片、map 等复合类型字段本身没有 tag，只有它的元素类型（如
[]User中的User）才可能有
第三方库对 tag key 的大小写和语义敏感
不同库对同一 tag key 的解析逻辑可能冲突。比如 json:"name"` 和 <code>gorm:"column:name" 都叫 name，但 json 库只认双引号内内容，gorm 却会进一步解析 column:name 里的冒号后部分。更麻烦的是大小写：yaml:"Name" 和 yaml:"name" 在某些版本 yaml 库中行为不一致。
立即学习“go语言免费学习笔记（深入）”；
- 不要混用同名 tag key 表达不同含义，比如既用
db:"id"又用redis:"id"—— 没有标准约束，库之间不互通 - 用
go vet或静态检查工具（如staticcheck）能捕获部分非法 tag 格式，但无法验证语义是否符合某库预期 - 生产环境上线前，务必用真实数据跑一遍各序列化/ORM 流程，tag 错一位，字段就丢一次
struct tag 看似只是字符串，但它横跨编译期语法、运行时反射、多库约定三层。最常出问题的地方不在怎么写，而在“以为写了就有用”——实际可能被忽略、被截断、或被另一层逻辑覆盖。
