Golang嵌套属性YAML转JSON问题求助：反序列化与字段提取

问题1：无法反序列化多个条目（报错cannot unmarshal !!map into []item.Item） #

这个错误的核心是你的Go结构体类型和YAML文件的根结构不匹配，我们分两种常见场景处理：

场景A：YAML根是数组（条目以-开头）

如果你的YAML是这种数组格式：

- id: 101
  description:
    en: "Wireless Headphones"
- id: 102
  description:
    en: "Bluetooth Speaker"

你需要用切片类型[]Item来接收，同时结构体要精准匹配嵌套结构：

type Item struct {
    ID          string       `yaml:"id"`
    Description Description `yaml:"description"`
}

type Description struct {
    EN string `yaml:"en"` // YAML键是en，tag要严格对应
}

反序列化代码：

var items []Item
err := yaml.Unmarshal(yamlBytes, &items)
if err != nil {
    log.Fatal(err)
}

场景B：YAML根是键值对（map结构）

如果你的YAML是这种键值映射格式：

headphones:
  id: 101
  description:
    en: "Wireless Headphones"
speaker:
  id: 102
  description:
    en: "Bluetooth Speaker"

你需要用map类型map[string]Item来接收，之后可遍历map提取所有条目：

var itemMap map[string]Item
err := yaml.Unmarshal(yamlBytes, &itemMap)
if err != nil {
    log.Fatal(err)
}
// 可选：把map转成切片方便后续处理
var items []Item
for _, item := range itemMap {
    items = append(items, item)
}

只要让Go接收类型和YAML根结构对齐，这个报错就能解决。

问题2：提取嵌套属性并转扁平JSON #

要把item.description.en这类嵌套字段扁平化成description_en顶级键，最直观的方式是手动构造扁平的map[string]interface{}，再序列化成JSON——这种方式清晰可控，适合大多数场景。

示例代码（基于上面的[]Item切片）：

import "encoding/json"

// 构造扁平结构
var flatItems []map[string]interface{}
for _, item := range items {
    flat := map[string]interface{}{
        "id":               item.ID,
        "description_en":   item.Description.EN,
        // 如果有其他语言字段，比如中文，直接扩展
        // "description_zh": item.Description.ZH,
    }
    flatItems = append(flatItems, flat)
}

// 转成格式化后的JSON字符串
jsonBytes, err := json.MarshalIndent(flatItems, "", "  ")
if err != nil {
    log.Fatal(err)
}
fmt.Println(string(jsonBytes))

如果嵌套结构极复杂、字段数量极多，也可以用Go反射自动遍历嵌套结构实现扁平化，但手动构造在可读性和维护性上更有优势。

内容的提问来源于stack exchange，提问作者Eieio