本文详解 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 非空。推荐写法如下：

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)
    }
}

⚠️ 注意事项：

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

• 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 客户端。