Go结构体Tag必须用空格分隔，不可用逗号；key后value须双引号包裹，reflect.StructTag.Get()返回值需手动校验是否为空，解析嵌套结构体需递归处理，多tag并存时应按用途分键且避免滥用。
结构体Tag里用空格还是逗号分隔
Go 的 struct tag 值必须用反引号包裹，且内部字段用空格分隔——不是逗号，不是分号，也不是换行。常见错误是抄 JSON tag 写法，误写成 `json:"name,required"`，这会让 reflect.StructTag.Get() 返回空字符串，因为 Go 只认空格分隔的 key:"value" 对。
正确写法是：`json:"name" validate:"required"`。多个 tag 并列时，每个 key:value 独立，中间只允许一个或多个空白字符（空格、tab、换行都算），但实际建议统一用单个空格，避免解析歧义。
- key 必须是 ASCII 字母或下划线开头，不能含点、中划线、数字开头
- value 必须用双引号包裹，且内部双引号需转义（
"\"quoted\""） - 如果 value 为空（如
`yaml:"-"`），仍需保留双引号，不能写成 <code>`yaml:-`
用 reflect.StructTag.Get() 提取 tag 值的陷阱
reflect.StructTag.Get() 是最常用也最容易出错的方式。它只做简单 key 匹配，不解析 value 内容，也不校验格式。比如 `json:"id,omitempty" db:"id"`，调用 tag.Get("json") 返回 "id,omitempty"，但如果你没手动切分逗号，就直接当完整字段名用了，后续序列化可能出错。
更隐蔽的问题是：如果 tag 里有非法格式（比如少了一个双引号），Get() 不报错，而是静默返回空字符串——你得自己检查返回值是否为空，否则反射取到空名，运行时报 panic: reflect: FieldByName of non-struct type 这类错，定位困难。
立即学习“go语言免费学习笔记（深入）”；
- 永远检查
Get()返回值是否为空，尤其在关键字段（如数据库主键映射）上 - 不要依赖
Get()自动拆解omitempty这类修饰符；需要时用strings.SplitN(val, ",", 2)手动分离 - 第三方库（如
mapstructure、validator）通常已封装好解析逻辑，直接用它们比手撸reflect更稳
自定义 tag 解析器为什么总漏掉嵌套结构体字段
反射遍历结构体字段时，reflect.Value.Field(i) 只拿到当前层级字段，不会自动递归进内嵌结构体。如果你写了个通用 tag 解析函数，只循环 t.NumField()，那 type User struct { Profile Profile } 里的 Profile.Name 就根本不会被扫描到。
真正要覆盖全字段，得写递归逻辑：遇到 Kind() == reflect.Struct 且不是匿名字段（或根据需求决定是否处理匿名字段），就继续调用自身；同时注意循环引用（比如 A 包含 B，B 又包含 A），得用 reflect.Type 做 visited 缓存，否则栈溢出。
- 匿名字段默认会被提升，tag 会继承，但显式嵌套结构体不会——这是设计使然，不是 bug
- 用
field.Anonymous判断是否为匿名字段，再决定是否展开其内部 tag - 别在解析阶段做深度拷贝或构造新结构体，容易触发不必要的内存分配和 GC 压力
JSON tag 和数据库字段映射 tag 冲突怎么办
一个结构体既要 JSON 序列化，又要 ORM 映射，json 和 gorm（或 sqlx、ent）tag 经常打架。比如 CreatedAt 字段，JSON 要 created_at，数据库要 created_at timestamp，但 gorm:"column:created_at;type:timestamp" 里带空格和分号，和 JSON tag 格式不兼容。
Go 允许并存多个 tag，只要 key 不同就行。关键是别混用——json 只管序列化，gorm 只管 ORM，两者互不干扰。但要注意：某些库（如 sqlx）默认读 db tag，而 gorm 默认读 gorm，别把 gorm tag 错贴成 db，否则字段映射直接失效，查出来全是零值。
- 用 IDE 的 tag 高亮功能（如 GoLand）快速识别拼写错误，
gorm写成grom这种低级错很常见 - 避免在同一个字段上滥用 tag，比如加
validate、json、xml、form、yaml五六个，维护成本陡增 - 如果项目里大量重复 tag 组合（如所有时间字段都要
json:",omitempty" gorm:"autoCreateTime"），考虑用代码生成（go:generate+ast解析）替代手工复制
Struct tag 表面简单，实际每层反射调用都在放大格式错误的影响；最麻烦的不是写错，而是错得不够明显——程序照跑，数据悄悄丢。多打两行校验，比线上查一小时 tag 拼写强得多。
