本文详解 Go 中解析含嵌套数组的 JSON 数据时的结构体定义技巧，重点解决因 JSON 结构与 Go 结构不匹配导致的 index out of range 运行时错误，并提供健壮、可扩展的解码实践。
本文详解 go 中解析含嵌套数组的 json 数据时的结构体定义技巧，重点解决因 json 结构与 go 结构不匹配导致的 `index out of range` 运行时错误，并提供健壮、可扩展的解码实践。
在 Go 中解析 JSON 时，结构体字段名与 JSON 键名的映射必须精确匹配，且需充分考虑数据的实际存在性与嵌套层级。你遇到的 index out of range 错误并非源于结构体定义本身（results/result/hit 基本合理），而是未对 JSON 解析结果做空值或长度校验就直接访问 t.Result[0].Hits —— 当 results 数组为空、或 results[0].hits 为空时，下标访问必然 panic。
首先，修正结构体命名规范：Go 推荐导出（首字母大写）字段以支持 JSON 反序列化，因此应将 results、result、hit 改为 Results、Result、Hit：
type Results struct {
Result []Result `json:"results"`
}
type Result struct {
Hits []Hit `json:"hits"`
}
type Hit struct {
Name string `json:"title"`
URL string `json:"author:url"` // 字段名可更语义化，如 URL 而非 Url
}其次，关键改进在于安全遍历。永远不要假设 t.Result 至少有一个元素或 t.Result[0].Hits 非空。推荐写法如下：
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
var t Results
err := json.NewDecoder(resp.Body).Decode(&t)
if err != nil {
log.Fatal("JSON decode error:", err)
}
// 安全遍历：先检查 results 是否非空
if len(t.Result) == 0 {
fmt.Println("No results returned")
return
}
// 再检查 hits 是否非空
for _, r := range t.Result {
for _, h := range r.Hits {
m[h.Name] = h.URL
fmt.Printf("Name: %s, URL: %s\n", h.Name, h.URL)
}
}⚠️ 注意事项：
author:url是合法 JSON 键（含冒号），Go 的json标签可直接使用"author:url"，无需转义；- 若
resp.Body已被其他代码读取（如调用ioutil.ReadAll），再次解码会失败——确保仅读取一次；- 对于生产环境，建议使用
json.RawMessage延迟解析深层结构，或结合errors.Is(err, io.EOF)等做更细粒度错误处理；- 若 JSON 响应结构不稳定（如
results可能缺失），可为顶层结构添加json:",omitempty"并配合指针字段（如*[]Result）提升容错性。
最后，针对你补充的 Algolia 查询示例：该请求返回的是 {"results": [...]}，但你的实际请求体是 {"requests":[...]}，二者结构完全不同。请确认服务端真实响应格式——可先打印 io.ReadAll(resp.Body) 调试，再设计对应结构体。切勿基于假设建模。
总结：Go JSON 解析的核心原则是 “结构体即契约，校验即习惯”。定义清晰、导出字段、严格校验长度、分层遍历，即可彻底规避索引越界风险，并构建高鲁棒性的 API 客户端。
