go 的 reflect.Structtag 解析会将反斜杠视为转义符导致截断，需源码写 \ 保留单个 ；含空格/冒号等特殊字符的值必须用双引号包裹；key 严格大小写敏感且不可有空格；structtag 不解析语义（如 .），需上层自行处理。
反射读取含反斜杠的 Tag 字符串时内容被截断
Go 的 reflect.StructTag 解析会把 当作转义起始，导致后续字符（比如 " 或 ）被误处理，实际拿到的 tag 值比源码里写的少一截。
根本原因是 reflect.StructTag.Get 底层调用的是 Go 的字符串字面量解析逻辑 —— 它不区分「结构体 tag 原始字符串」和「代码中写的字符串字面量」。你在 struct 上写 `json:"name""`, Go 编译器先按字符串字面量规则吃掉一个 <code>，再传给反射系统，这时 reflect 已经看不到原始的双反斜杠了。
- 想保留字面量中的
，必须在源码里写成（即两个反斜杠），让编译器解码成一个传给 tag - 如果 tag 来自外部配置（比如 YAML 文件注入），别直接拼进 struct 定义；改用运行时动态构造
reflect.StructField+ 手动设置Tag字段 - 验证方式：打印
reflect.typeof(T{}).Field(0).Tag的原始字符串，用%q格式化，看是否包含预期的
用 reflect.StructTag.Get 提取带空格或冒号的值失败
Tag 值里如果出现未引号包裹的空格、冒号或等号，Get 会按简单分词规则切开，比如 `api:"GET /users/:id"` 被拆成 GET 和 /users/:id 两段，后者丢失前缀。
Go 的 tag 解析器只认双引号包裹的值，且不支持转义引号以外的字符。一旦值里有空格、:、=、,，又没加引号，就必然被截断。
- 所有含特殊字符的 tag 值必须用双引号包住，例如
`api:"GET /users/{id}"` - 如果值本身要包含双引号，只能写成
`api:"GET /users/"id""`（注意：这里需要两个，一个给字符串字面量，一个给 tag 解析器） - 避免在 tag 里塞复杂语法，比如正则或路径模板；改用独立的注解结构体字段，通过反射+类型断言获取
自定义 tag 解析器无法识别嵌套语法（如 json:"a.b.c" 中的点号）
reflect.StructTag 本身不解释语义，它只负责按规则拆出 key-value 对。像 json:"a.b.c" 里的 . 是 json 包自己约定的嵌套路径语法，反射层完全不管——你得自己 parse value 字符串。
很多库直接调用 tag.Get("json") 拿到 "a.b.c" 就完事，但如果你要实现类似 json.Unmarshal 的字段映射逻辑，就必须额外做 Token 切分、通配符展开、可选字段标记等。
- 不要假设 tag 值是扁平标识符；检查是否含
.、[、?等符号，它们大概率属于上层协议的 DSL - 对常见 tag（如
json、xml、yaml）优先复用对应标准库的解析逻辑，而不是从头写 - 如果要支持自定义语法（比如
path:"/v1/users/{id:int}"），必须在反射之后、实际使用前做一次专用 parser，不能依赖StructTag自动识别
反射解析 tag 时忽略大小写或空格导致匹配失败
Go 的 StructTag 对 key 是严格大小写敏感的，json 和 JSON 完全不同；value 内部的空格也照单全收，不会 trim。
常见错误是手写 tag 时大小写不一致，或者用字符串拼接生成 tag 时多加了空格，比如 `json: "name"`（冒号后有空格）会导致 tag.Get("json") 返回空字符串。
- key 必须全小写，且与目标库要求完全一致（
json、yaml、db，不是JSON或Json） - 冒号必须紧贴 key，后面不能有空格；value 如果用引号包裹，开头结尾也不能有空格
- 调试时用
fmt.printf("tag raw: %q ", field.Tag)直接看原始字节，比肉眼判断更可靠
事情说清了就结束。最麻烦的从来不是反射本身，而是 tag 这个看似简单的字符串，在编译、反射、业务解析三层之间各吃一口，最后谁都没拿到完整信息。