本文详解 Go 中使用 json.Decoder 解析 JSON 的常见错误（如字段未导出导致解码失败），提供结构体定义规范、JSON 标签用法，并演示如何不依赖预定义结构体，直接解析为 map[string]interface{} 动态提取键值。
本文详解 go 中使用 `json.decoder` 解析 json 的常见错误（如字段未导出导致解码失败），提供结构体定义规范、json 标签用法，并演示如何不依赖预定义结构体，直接解析为 `map[string]interface{}` 动态提取键值。
在 Go 中解析 JSON 时，一个极易被忽略却至关重要的规则是：只有首字母大写的导出字段（exported fields）才能被 encoding/json 包读写。你原代码中 name string 是小写开头的非导出字段，因此 json.Decoder.Decode() 无法为其赋值——这正是 fmt.Println(weather.name) 始终打印空字符串（零值）的根本原因。
✅ 正确声明结构体：导出字段 + JSON 标签
type Weather struct {
Name string `json:"name"` // 导出字段 + 显式指定 JSON key
}
同时，需确保完整解析响应体。注意：你的示例 JSON 是单个顶层对象（而非数组），因此只需调用一次 Decode()，无需 for 循环（除非你明确处理流式 JSON 数组）。修正后的典型用法如下：
resp, err := http.Get("https://api.example.com/weather")
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
var weather Weather
decoder := json.NewDecoder(resp.Body)
if err := decoder.Decode(&weather); err != nil {
log.Fatal("JSON decode error:", err)
}
fmt.Println("City name:", weather.Name) // 输出: City name: Cairns
? 动态解析未知结构：使用 map[string]interface{}
当 JSON 结构不确定、字段名动态变化或仅需临时提取少数字段时，可跳过结构体定义，直接解码为通用映射：
var data map[string]interface{}
if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
log.Fatal(err)
}
// 安全提取嵌套值（需类型断言）
if name, ok := data["name"].(string); ok {
fmt.Println("Name from map:", name) // Cairns
}
if main, ok := data["main"].(map[string]interface{}); ok {
if temp, ok := main["temp"].(float64); ok {
fmt.Printf("Temperature: %.2fK\n", temp) // Temperature: 300.15K
}
}
⚠️ 注意：map[string]interface{} 中的值类型需手动断言（string, float64, []interface{}, nil 等），建议配合 errors.Is(err, json.UnmarshalTypeError) 做健壮性检查。
? 实用技巧与建议
- 自动生成结构体：粘贴 JSON 到 json-to-go 可一键生成带正确标签和嵌套结构的 Go struct。
- 避免循环解码单对象：for { Decode() } 适用于 JSON Lines（每行一个 JSON 对象）或流式数组；普通单对象响应请用单次 Decode()。
- 错误处理优先：始终检查 err == io.EOF（仅对流式场景有意义）及其它解码错误，切勿忽略。
- 性能考量：结构体解码比 map 更快、内存更省且类型安全；map 适用于原型开发或高度动态场景。
掌握导出规则与灵活的数据载体选择，即可在 Go 中高效、可靠地处理任意 JSON 数据。
