本文详解如何在 Go 中正确解码含嵌套结构的 JSON 数据，特别是键值为“切片+映射”（如 []map[string]string）的字段，避免因类型不匹配导致解析失败或空值。
本文详解如何在 go 中正确解码含嵌套结构的 json 数据，特别是键值为“切片+映射”（如 `[]map[string]string`）的字段，避免因类型不匹配导致解析失败或空值。
在 Go 中解析 JSON 时，结构体字段类型必须与 JSON 数据的实际结构严格对应。你遇到的问题根源在于：JSON 中 "activities" 是一个对象数组（即 [{"name": "running"}, {"name": "swimming"}]），它本质上是一组键值对的集合，而非字符串切片。因此，将 Activities 字段声明为 []string 会导致 json.Unmarshal 无法匹配类型，静默失败（返回零值：空切片、零整数等），且不报错——除非你显式检查错误。
正确的做法是使用 []map[string]string 类型，它表示“字符串映射的切片”，能准确对应 JSON 中的数组+对象结构：
package main
import (
"encoding/json"
"fmt"
)
type Response struct {
Page int `json:"page"`
Fruits []string `json:"fruits"`
Activities []map[string]string `json:"activities"`
}
func main() {
// 注意：原始问题中 JSON 存在语法错误（{"name", "swimming"} 应为 {"name": "swimming"}）
str := `{"page": 1, "fruits": ["apple", "peach"], "activities": [{"name": "running"}, {"name": "swimming"}]}`
var res Response
err := json.Unmarshal([]byte(str), &res)
if err != nil {
panic(err) // 实际项目中应妥善处理错误，例如记录日志并返回用户友好提示
}
fmt.Println("Page:", res.Page) // 输出: Page: 1
fmt.Println("Fruits:", res.Fruits) // 输出: Fruits: [apple peach]
fmt.Println("Activities:", res.Activities) // 输出: Activities: [map[name:running] map[name:swimming]]
// 遍历 activities 并提取 name 字段
for i, act := range res.Activities {
name, exists := act["name"]
if exists {
fmt.Printf("Activity %d: %s\n", i+1, name)
} else {
fmt.Printf("Activity %d: missing 'name' field\n", i+1)
}
}
}
关键注意事项：
- ✅ 类型必须精确匹配：[]map[string]string 适用于结构简单、字段名已知且值均为字符串的场景；若 activities 中还包含数字、布尔值或嵌套对象（如 {"name": "running", "duration": 30, "completed": true}），则应定义专用结构体（如 type Activity struct { Name stringjson:"name"Duration intjson:"duration"Completed booljson:"completed"}），并将字段改为 []Activity。
- ✅ 务必检查 Unmarshal 错误：Go 的 JSON 解析不会因类型不匹配而 panic，但会跳过该字段并填充零值。忽略 err 将掩盖严重逻辑缺陷。
- ✅ 注意 JSON 语法有效性：示例中 "name", "swimming" 是非法 JSON（缺少冒号），实际运行前需修正为 "name": "swimming"。可借助在线工具（如 jsonlint.com）验证。
- ⚠️ 性能与可维护性权衡：[]map[string]string 灵活但缺乏类型安全和 IDE 支持；长期项目推荐使用强类型结构体，提升可读性、可测试性和编译期检查能力。
总结：解析 JSON 数组中的对象，核心是选择与数据形状一致的 Go 类型——[]map[string]string 是快速适配动态键值对的简洁方案，但严谨工程实践应优先采用定制结构体，并始终校验解码错误。
