结构体字段标签是可被反射读取的元数据，必须用反引号包裹、空格分隔多标签，通过reflect.StructTag.Get安全提取；需递归处理嵌套与匿名字段，标签设计应简洁声明式，避免嵌入逻辑。
结构体字段标签不是注释，是可被反射读取的元数据
Go 的结构体字段标签（如 `json:"name"`）不是注释，也不是编译期忽略的内容。它在运行时可通过 reflect.StructTag 解析，是 ORM、序列化、校验等框架依赖的核心机制。很多人误以为标签只是给 json.Marshal 用的，其实只要手动调用 field.Tag.Get("xxx")，就能提取任意自定义标签，比如 `db:"user_name,type:varchar(32)"`。
常见错误：把标签写成 // db:"id" 或 /* db:"id" */ —— 这类注释完全无法被 reflect 读取；或者漏掉反引号，写成 "db:\"id\""（双引号字符串），导致编译失败或标签为空。
- 标签必须用反引号包裹：
`db:"id"`，不能用双引号或单引号 - 多个键值对用空格分隔：
`json:"name" db:"user_name" validate:"required"` - 键名不区分大小写，但值内容区分：
Tag.Get("JSON")和Tag.Get("json")都能取到"name" - 若值含逗号、等号、空格，需用双引号包裹：
`db:"\"user_id\",primary:true"`
用 reflect.StructTag.Get 安全提取标签值
直接访问 field.Tag 是 reflect.StructTag 类型，不是字符串。不能用 string(field.Tag) 强转，而应统一走 .Get(key) 方法。该方法返回空字符串表示键不存在，不会 panic，适合做存在性判断。
容易踩的坑：用 strings.Split(string(field.Tag), " ") 手动解析 —— 标签值里可能有带空格的字符串（如 `gorm:"column:user name"`），手动切分必然出错。
立即学习“go语言免费学习笔记（深入）”；
- 正确方式：
dbTag := field.Tag.Get("db")，拿到原始值后按需解析（如用strings.SplitN(dbTag, ",", 2)拆键值对） - 若标签格式固定，建议封装解析函数，避免每处重复写
strings.Trim、strings.TrimSpace -
Tag.Get对大小写不敏感，但不要依赖这点 —— 统一用小写键名（如"db"而非"DB"）更可靠
自定义标签解析时，别忽略结构体嵌套与匿名字段
ORM 场景下常遇到嵌套结构体（如 User 包含 Profile 字段），或用匿名字段继承（如 type User struct { Base }`）。这时仅遍历一级字段会漏掉关键映射信息。
典型现象：数据库建表时 missing created_at 字段，查了半天发现它定义在嵌套的 Base 结构体里，但主结构体反射时没递归处理。
- 需递归调用
reflect.TypeOf(v).Elem()（若是指针）再.NumField()遍历所有字段 - 对每个字段检查
field.Anonymous == true，若是匿名字段，要展开其类型继续解析 - 注意循环引用风险：两个结构体互相嵌套匿名字段，不做深度限制会栈溢出
- 生产级 ORM（如 GORM）实际采用缓存 + 深度限制（默认 5 层）+ 类型白名单来规避问题
标签值设计要兼顾可读性与解析鲁棒性
初学者常把复杂逻辑塞进标签值，比如 `db:"expr:COALESCE(name, 'anonymous')"`，看似灵活，实则难以维护且易出错。标签本质是声明式元数据，不是执行环境。
真实项目中，标签越“瘦”，框架越稳定。GORM 用 column、type、default 等离散键，而不是拼接长表达式。
- 推荐用键值对形式：
`db:"name" db_type:"varchar(64)" db_default:"''"`，而非`db:"name,varchar(64),''"` - 避免在标签里写 Go 表达式、SQL 片段或 JSON —— 这些应该由上层逻辑处理，不是标签职责
- 如果真需要动态行为（如条件字段映射），应通过额外接口（如实现
Scanner/Valuer）或配置对象，而非塞进标签
标签不是万能胶，它只负责“告诉框架字段叫什么、存哪儿、怎么序列化”。真正复杂的映射逻辑，得靠代码写清楚，而不是靠一行标签硬扛。
