Go语言解析嵌套JSON必须定义层级匹配的结构体，不支持点号路径直接取值；需确保字段首字母大写、类型一致，并用json:"key"标签精确映射，嵌套对象对应嵌套struct，数组对应[]T。
用 json.Unmarshal 解析嵌套结构前先定义匹配的 Go struct
Go 不支持像 Python 那样用点号路径（如 "server.port"）直接取值，必须先将 JSON 映射到有层级的 struct。否则用 map[string]interface{} 硬解，会很快陷入类型断言嵌套地狱。
实操建议：
- 用工具如 json-to-go 把示例 JSON 转成 struct，再手动补上
json:tag（注意字段首字母大写） - 嵌套对象对应嵌套 struct 字段；数组对应
[]T；可选字段加omitempty，但读配置时通常不加——空值也要显式感知 - 如果 JSON 键含连字符（如
"max-retries"），struct tag 必须写成json:"max-retries"，否则解析失败且静默忽略
用 gjson 按路径字符串快速提取嵌套字段（无需预定义 struct）
当配置结构多变、或只读个别深层字段（比如 CI 脚本里查 "features.auth.enabled"），gjson 是更轻量的选择：它不反序列化整个结构，而是流式解析并支持路径语法。
常见错误现象：
立即学习“go语言免费学习笔记（深入）”；
- 路径写成
"features.auth.enabled"却返回false—— 实际键名可能是"features.Auth.Enabled"，大小写敏感 - 数组索引写错，如
"items.0.name"但items是空数组，结果Value.Exists()返回false - 忘记检查
Value.Type == gjson.String就直接调String()，遇到null会返回空字符串，掩盖缺失问题
示例片段：
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
data, _ := os.ReadFile("config.json")
v := gjson.GetBytes(data, "database.pool.max_connections")
if v.Exists() && v.IsNumber() {
max := int(v.Int())
}
用 go-yaml + json 双格式兼容时注意字段映射差异
很多项目实际用 YAML 写配置（更易读），但底层仍走 JSON 解析逻辑。这时 go-yaml 的 unmarshal 行为和 encoding/json 不完全一致，尤其对空值和类型推断。
关键差异点：
- YAML 的
null或空字符串字段，在 struct 中若字段是*string，go-yaml会设为nil；而 JSON 解析器对"field": null同样设nil，但对"field": ""会设为空字符串 —— 这个区别容易导致配置行为不一致 - YAML 的布尔值
on/off、yes/no会被go-yaml自动转成true/false；JSON 没这机制，只能写true/false - 如果混用两种格式加载同一份 struct 定义，建议统一用
go-yaml解析（它兼容 JSON 子集），避免逻辑分叉
路径读取失败时，别只靠 panic 或忽略，要区分「键不存在」和「类型不匹配」
配置读取错误常被当成“文件没找到”处理，但真实原因往往是路径写错或类型预期不符。例如把 "timeout" 当作 int 读，但 JSON 里是字符串 "30s"，json.Unmarshal 会静默失败并保留字段零值。
排查建议：
- 用
json.RawMessage先捕获原始字段内容，打印出来确认实际结构 - 对关键配置字段，加一层校验函数，比如
requireInt("server.port", v)，内部检查v.Kind == reflect.Int或尝试strconv.Atoi - 日志里不要只写
"failed to load config"，而要带上下文：路径、期望类型、实际值（截断防泄露）
嵌套深、格式杂、变更频的配置，最麻烦的从来不是解析本身，而是错误信息太模糊——你得让失败说话，而不是自己猜。
