本文详解如何用 Go 的 encoding/json 正确解析含未知字符串键（如 "6581"、"6591"）的嵌套 JSON，指出硬编码字段名的误区，并提供 map 方案与固定键的替代方案。
本文详解如何用 go 的 `encoding/json` 正确解析含未知字符串键（如 `"6581"`、`"6591"`）的嵌套 json，指出硬编码字段名的误区，并提供 map 方案与固定键的替代方案。
在 Go 中解析 JSON 时，若嵌套对象的键名是动态的、运行时才确定的字符串（例如 "6581"、"6591"），直接将 result 字段声明为含固定字段（如 Efid1、Efid2）的匿名结构体是无效的——因为 Go 的结构体字段名与 JSON 键名必须严格对应，而 "6581" 并非合法的 Go 标识符，也无法通过结构体字段自动匹配。
正确的做法是将 result 声明为 map[string]T 类型，其中 T 是承载每个条目数据的结构体。这样 JSON 解析器能自动将任意字符串键映射到 map 的 key，再将对应值反序列化为结构体：
type VoteResult struct {
Total int `json:"total"`
Result map[string]struct {
Percent float64 `json:"percent"`
Count int `json:"count"`
} `json:"result"`
}
完整可运行示例：
package main
import (
"encoding/json"
"fmt"
)
type VoteResult struct {
Total int `json:"total"`
Result map[string]struct {
Percent float64 `json:"percent"`
Count int `json:"count"`
} `json:"result"`
}
func main() {
b := []byte(`{
"total": 5689,
"result": {
"6581": {"percent": 37.79, "count": 2150},
"6591": {"percent": 35.31, "count": 2009},
"6601": {"percent": 26.89, "count": 1530}
}
}`)
var v VoteResult
if err := json.Unmarshal(b, &v); err != nil {
panic(err)
}
fmt.Printf("Total: %d\n", v.Total)
for efid, data := range v.Result {
fmt.Printf("EFID %s → Percent: %.2f, Count: %d\n", efid, data.Percent, data.Count)
}
}
输出：
Total: 5689 EFID 6581 → Percent: 37.79, Count: 2150 EFID 6591 → Percent: 35.31, Count: 2009 EFID 6601 → Percent: 26.89, Count: 1530
⚠️ 注意事项：
- 不要用匿名结构体内嵌固定字段模拟动态键（如原代码中 Efid1, Efid2），这会导致字段无法被 JSON 解析器识别，值保持零值（0, 0.0）；
- 若键名完全固定且已知（如仅 "6581"/"6591"/"6601" 三种），可借助 JSON tag 显式绑定：
Result struct { Efid1 struct { /* ... */ } `json:"6581"` Efid2 struct { /* ... */ } `json:"6591"` Efid3 struct { /* ... */ } `json:"6601"` } `json:"result"`但此方式缺乏扩展性，新增键需手动修改结构体，不推荐用于真实业务场景；
- map[string]T 是处理动态键的标准、安全且可扩展的方案，适用于 API 响应中键名由服务端动态生成的常见场景（如 ID 映射、多语言字段、配置分组等）。
总结：面对 JSON 中以字符串为键的嵌套对象，优先选择 map[string]Struct 模式，它语义清晰、解耦灵活，并完全契合 Go 的 JSON 反序列化机制。
