gjson.Get() 返回空是因为路径书写错误或字段不存在：必须用点号路径（如"user.profile.name"），数组索引支持"items.0.title"或通配符"items.#.title"，含连字符的key需单引号包裹（如"'word-class'"），且务必先调.Exists()再取值。
gjson.Get() 提取多层嵌套字段时为什么返回空？
因为 gjson.Get() 默认只支持点号路径（如 "user.profile.name"），遇到数组或混合结构就失效。比如 JSON 中有 "items":[{...},{...}]，直接写 "items.0.title" 可能取不到——gjson 要求数组索引必须用方括号，正确写法是 "items.#.title" 或 "items.0.title"（注意：仅当确定存在第 0 项时才安全）。
常见错误现象：gjson.Get(data, "results.data.0.text") 返回空，实际数据路径可能是 "results.#.data.#.text"；或者字段名含连字符（如 "word-class"），必须加引号写成 "word-class" → "'word-class'"（gjson 路径中需用单引号包裹）。
- 使用场景：解析语言学习 API 返回的带分页、多级嵌套、动态 key 的响应（如 Anki、Quizlet、自建词库接口）
- 参数差异：
gjson.GetBytes()和gjson.GetString()底层行为一致，但前者避免字符串拷贝，处理大 JSON 更高效 - 容易踩的坑：路径里混用
.和[0]（gjson 不识别方括号语法，只认#和数字索引）；未检查.Exists()就调.String()，导致空字符串掩盖缺失问题
提取带条件过滤的语言数据（如“词性为 verb 且例句数 ≥2”）
gjson 本身不支持条件过滤，得靠 gjson.Parse() 后遍历 + 手动判断。关键不是写循环，而是避免重复解析同一段 JSON 字符串——先用 gjson.Parse(data) 得到根对象，再对子路径反复调 .Get()，比每次 gjson.Get(data, path) 快得多。
示例：从 "words" 数组中筛选动词：
立即学习“go语言免费学习笔记（深入）”；
root := gjson.Parse(data)
var verbs []string
root.Get("words").ForEach(func(_, value gjson.Result) bool {
pos := value.Get("'part-of-speech'").String()
examples := value.Get("examples").Array()
if pos == "verb" && len(examples) >= 2 {
verbs = append(verbs, value.Get("lemma").String())
}
return true // 继续遍历
})
- 性能影响：
ForEach比多次Get()调用快 3–5 倍（实测 10KB JSON） - 兼容性注意：JSON key 含短横线、数字开头（如
"2nd-form"）必须用单引号包裹路径，否则解析失败 - 容易踩的坑：忘记
return true导致遍历提前终止；用value.String()取数组项却没判空，得到空字符串而非 panic
处理多语言字段（如 translations.en、translations.zh）的动态提取
硬编码 "translations.en" 不现实——语言代码来自用户配置或 API 动态返回。gjson 支持变量拼接路径，但要注意注入安全：不能直接拼接用户输入进路径字符串，需先白名单校验语言码（如 map[string]bool{"en":true,"zh":true,"ja":true}）。
正确做法：
lang := "zh"
if !validLangs[lang] {
return ""
}
path := "translations." + lang + ".text"
result := root.Get(path)
if result.Exists() {
return result.String()
}
- 使用场景：构建支持多语种释义、例句、音标的离线词典工具
- 容易踩的坑：用
fmt.Sprintf("translations.%s.text", userLang)且未校验，若userLang是"en..name"会误匹配到深层字段；忽略.Exists()直接取值，返回空字符串而非报错 - 性能提示：频繁切换语言时，可预编译常用路径（如
gjson.Path("translations.en.text")），但 gjson 当前版本不暴露该能力，暂以白名单+拼接为准
gjson 与 encoding/json 性能/适用边界怎么选？
如果你只需要读几个字段，gjson 几乎总是更快；如果要完整反序列化结构体并复用字段、做修改、再序列化回去，encoding/json 更合适。gjson 的零拷贝优势在 >5KB JSON 上才明显，小数据两者差别不到 0.1ms。
- 典型误用：用
gjson提取全部字段后手动组装 struct —— 不如直接json.Unmarshal() - 真实瓶颈常不在解析，而在后续字符串处理（如正则清洗例句、Unicode 标准化）；gjson 返回的
.String()是拷贝，.Raw才是原始字节引用，需自行确保生命周期 - 最容易被忽略的一点：gjson 不验证 JSON 合法性，坏数据会导致
.Get()静默失败；而json.Unmarshal()会明确报invalid character错误——调试阶段建议先用后者快速定位格式问题
