go Struct tag 怎么写才被 reflect 正确读取
Go 没有注解（Annotation），但用 struct field tag 能模拟类似能力。关键不是“加了标签就行”，而是格式必须严格：双引号包裹、键值对用空格分隔、值用反引号或双引号（推荐双引号）。
常见错误是漏掉双引号、用单引号、或在 tag 里写 Go 表达式（比如 `json:"name,omitempty" validate:"required"` 合法，`json:name` 或 `json:'name'` 都会失效）。
- 结构体字段必须是导出的（首字母大写），否则
reflect无法访问 - tag key 区分大小写，
json和JSON是两个不同 key - 如果值含双引号，需转义：
`validate:"gt=0,lt="100""` - 多个 tag 并列时，用空格隔开，不能用逗号或分号
reflect.StructTag.Get 和 reflect.StructTag.Lookup 的区别
两者都用来取 tag 值，但行为不同：Get 直接返回字符串（没找到就空串），Lookup 返回 (String, bool)，第二个返回值表示是否存在。生产代码务必用 Lookup，否则空串可能是“没这个 tag”也可能是“这个 tag 值就是空串”，无法区分。
-
tag.Get("json")→ 可能掩盖缺失 tag 的问题 -
if val, ok := tag.Lookup("validate"); ok { ... }→ 明确感知 tag 是否存在 - 注意：key 是 tag 中冒号前的部分，比如
`db:"user_id"`，key 是db，不是db:
用 reflect.StructField.Tag 解析嵌套校验规则（如 validate:"required,max=10"）
struct tag 值本身只是字符串，Go 不自动解析它的内部结构。想实现 java 注解那种“参数化”效果（比如 @NotBlank + @Size(max=10)），得自己切分、解析。
立即学习“Java免费学习笔记（深入）”；
别直接用 strings.Split 粗暴拆，因为值里可能含逗号（比如正则表达式 pattern="^a{1,3}$"）。推荐用轻量 parser，比如按逗号分割后逐段 trim，再用 = 拆键值，遇到无等号的视为布尔型开关（如 required）。
- 示例 tag：
`validate:"required,eq=42,pattern="^d+$""` - 先按逗号分段 →
["required", "eq=42", "pattern="^d+$""] - 每段用
strings.IndexByte(s, '=')判断是否含=，避免误切引号内内容 - 值带引号时，需手动去引号（只处理首尾匹配的双引号或反引号）
反射 + tag 的性能代价和替代方案
每次调用 reflect.typeof + 遍历字段 + 解析 tag，都是运行时开销。高频路径（如 http 请求中间件、数据库 ORM 字段映射）必须缓存结果，不能每次重解析。
典型做法：首次访问某结构体类型时，用 sync.Once 构建一个 map[reflect.Type]*fieldMeta，把 tag 解析结果、校验函数指针、序列化规则全预存好。后续直接查表。
- 未缓存时，10 万次 struct 检查可能多耗 50ms+；缓存后趋近于 0
- 编译期生成代码（如
go:generate+stringer风格工具）可彻底避开反射，但增加构建复杂度 - 简单场景（如配置加载）用反射没问题；高吞吐服务中，tag 解析逻辑一旦进 hot path，就得动真格缓存
真正麻烦的不是怎么写 tag，而是当你要支持 validate、json、db、yaml 多套语义共存时，各 tag 的语义冲突、优先级、默认值继承——这些没法靠反射自动解决，得靠约定和文档兜底。