本文详解 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() 会静默跳过它——既不报错，也不赋值，最终 weather.name 始终为空字符串，导致输出“什么也没有”。
✅ 正确做法是将字段改为导出形式，并通过 struct tag 显式指定 JSON 键名：
type Weather struct {
Name string `json:"name"`
}注意：json:"name" 表示该字段对应 JSON 中的 "name" 键；若 JSON 键名与 Go 字段名一致（如 Name ↔ "name"），tag 可省略，但显式声明更清晰、更健壮。
完整可运行示例（含错误处理与资源释放）：
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
package main
import (
"encoding/json"
"fmt"
"io"
"log"
"net/http"
)
type Weather struct {
Name string `json:"name"`
}
func main() {
// 模拟 HTTP GET 响应（实际中替换为 http.Get(...)）
res := &http.Response{
Body: io.NopCloser(
// 使用你的示例 JSON 片段（仅保留顶层 name 字段用于演示）
strings.NewReader(`{"coord":{"lon":145.77},"name":"Cairns","cod":200}`),
),
}
defer res.Body.Close()
decoder := json.NewDecoder(res.Body)
var weather Weather
if err := decoder.Decode(&weather); err != nil {
log.Fatal("JSON decode failed:", err)
}
fmt.Println("City name:", weather.Name) // 输出：City name: Cairns
}⚠️ 注意事项：
- json.Decoder 适用于流式解析单个 JSON 值（如一个对象或数组），而非多次调用 Decode() 解析多个独立对象（除非 JSON 是换行分隔的 NDJSON）。你原代码中的 for {...} 循环在处理单个 JSON 对象时会导致第二次 Decode() 立即返回 io.EOF，应移除循环。
- 始终调用 res.Body.Close() 防止连接泄漏。
- 若需调试 JSON 结构，推荐使用 JSON-to-Go 在线工具，粘贴原始 JSON 即可自动生成带完整嵌套结构和 tag 的 Go struct。
? 当 JSON 结构未知或动态变化时，可绕过 struct，直接解码为通用映射：
var data map[string]interface{}
if err := json.NewDecoder(res.Body).Decode(&data); err != nil {
log.Fatal(err)
}
if name, ok := data["name"].(string); ok {
fmt.Println("Dynamic name:", name)
}
// 支持嵌套访问：data["main"].(map[string]interface{})["temp"]这种方式牺牲了类型安全与编译期检查，但极大提升了灵活性，适合配置解析、API 原始响应探查等场景。
总结：Go 的 JSON 解码依赖字段导出性与 struct tag 协同工作；优先使用强类型的 struct 提升可维护性，必要时再选用 map[string]interface{} 实现动态处理——二者结合，即可稳健应对从固定 Schema 到完全未知结构的各类 JSON 解析需求。
