本文详解为何将 JSON 数组（如 "anleitung": [...]）错误声明为 map[string]struct{} 会导致 Go 反序列化失败，并提供标准、可运行的结构体定义方案。

本文详解为何将 json 数组（如 `"anleitung": [...]`）错误声明为 `map[string]struct{}` 会导致 go 反序列化失败，并提供标准、可运行的结构体定义方案。

在 Go 中解析 JSON 时，数据类型必须严格匹配 JSON 的实际结构。题中 JSON 片段里的 "anleitung" 字段是一个数组（JSON array），例如：

"anleitung": [
  { "blog": "title", "link": "http://domain.tld/" },
  { "blog": "Test",  "link": "http://google.at" }
]

但原结构体却将其定义为：

Anleitung map[string]struct {
    Name string `json:"blog"`
    Link string `json:"link"`
} `json:"anleitung"`

这是根本性错误：map[string]T 对应的是 JSON 对象（object），即键值对集合（如 {"a": {...}, "b": {...}}），而 JSON 数组 [] 必须用 Go 的切片（[]T） 来表示。

✅ 正确做法是将 Anleitung 声明为切片：

Wjs Uploading Video

将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。

下载

type Jailbreak struct {
    Jailbroken bool `json:"jailbroken"`
    Name       string `json:"name"`
    Version    string `json:"version"`
    URL        string `json:"url"`
    Anleitung  []struct { // ✅ 切片 —— 对应 JSON 数组
        Name string `json:"blog"`
        Link string `json:"link"`
    } `json:"anleitung"`

    Firmwares struct {
        Start string `json:"start"`
        End   string `json:"end"`
    } `json:"ios"`

    Platforms []string `json:"platforms"`
    Caveats   string   `json:"caveats"`
}

// 外层需包裹 jailbreaks 数组
type Jailbreaks struct {
    List []Jailbreak `json:"jailbreaks"`
}

完整解析示例：

func main() {
    jsonData := `{
        "jailbreaks": [
            {
                "jailbroken": true,
                "name": "Yalu102",
                "version": "beta 6",
                "url": "https://domain-dl.tld",
                "anleitung": [
                    {"blog": "title", "link": "http://domain.tld/"},
                    {"blog": "Test",  "link": "http://google.at"}
                ],
                "ios": {"start": "10.2", "end": ""},
                "platforms": ["Windows", "OS X", "Linux"],
                "caveats": "some text here"
            }
        ]
    }`

    var data Jailbreaks
    if err := json.Unmarshal([]byte(jsonData), &data); err != nil {
        log.Fatal("JSON 解析失败:", err)
    }

    fmt.Printf("共 %d 个越狱工具\n", len(data.List))
    for i, jb := range data.List {
        fmt.Printf("[%d] %s (v%s) — %t\n", i+1, jb.Name, jb.Version, jb.Jailbroken)
        fmt.Printf("  教程数: %d\n", len(jb.Anleitung))
        for _, step := range jb.Anleitung {
            fmt.Printf("    • %s → %s\n", step.Name, step.Link)
        }
    }
}

⚠️ 注意事项：

• JSON 中若某字段为 []（空数组），Go 切片会自动初始化为 nil 或空切片（取决于 json.Decoder 设置），无需额外处理；
• 若 JSON 中 anleitung 可能为 null，建议使用指针切片 *[]struct{...} 或自定义 UnmarshalJSON 方法做容错；
• map[string]struct{} 仅适用于明确以字符串为键的 JSON 对象（如配置项映射），切勿用于数组场景；
• 使用 json 标签时，确保字段首字母大写（导出），否则 json.Unmarshal 无法赋值。

总结：JSON array ↔ Go []T；JSON object ↔ Go map[K]V 或 struct{}。类型不匹配是 Go JSON 解析失败最常见的原因，务必对照原始 JSON 结构逐字段校验 Go 类型定义。