使用 YAML 路径扁平化映射简化动态解析_技术教程

本文介绍一种更简洁的 go 语言 yaml 动态解析方案：将嵌套 yaml 结构扁平化为带点号分隔路径的字符串键值对（如 `"b.c.f" → "third"`），避免反复类型断言，提升可读性与访问效率。

在 Go 中动态解析 YAML（即不预定义结构体）时，标准做法是使用 map[interface{}]interface{}，但深层嵌套访问需频繁进行类型断言（如 .("map[interface{}]interface{}")），不仅冗长易错，也不利于遍历和路径查询。

一个更优雅的替代方案是扁平化（flattening）YAML 数据结构：将原始嵌套结构转换为 map[string]string，其中键采用类似 JSONPath 的点号分隔路径（如 "b.c.f"），值统一转为字符串表示。这样，任意层级的字段均可通过单一字符串键直接访问，无需类型判断或嵌套解包。

以下是完整实现示例：

package main

import (
    "fmt"
    "gopkg.in/yaml.v2"
    "log"
)

func main() {
    out := `
a: First!
f: Second
b:
  c:
    f: Third
    g:
      - zero
      - one
      size: 2
`

    // 先反序列化为 map[string]interface{}（比 map[interface{}]interface{} 更易处理）
    any := map[string]interface{}{}
    err := yaml.Unmarshal([]byte(out), &any)
    if err != nil {
        log.Fatal(err)
    }

    // 扁平化为 path → string 映射
    flatmap := make(map[string]string)
    for k, v := range any {
        flatten(k, v, flatmap)
    }

    // 输出所有扁平化键值对
    for k, v := range flatmap {
        fmt.Printf("%q = %q\n", k, v)
    }
    // 输出示例：
    // "a" = "First!"
    // "f" = "Second"
    // "b.c.f" = "Third"
    // "b.c.g.0" = "zero"
    // "b.c.g.1" = "one"
    // "b.c.g.size" = "2"
}

// flatten 递归展开嵌套结构，生成点号路径
func flatten(prefix string, value interface{}, flatmap map[string]string) {
    // 处理 map[string]interface{}
    if submap, ok := value.(map[string]interface{}); ok {
        for k, v := range submap {
            newKey := prefix + "." + k
            flatten(newKey, v, flatmap)
        }
        return
    }

    // 处理 []interface{}（YAML 序列）
    if slice, ok := value.([]interface{}); ok {
        flatmap[prefix+".size"] = fmt.Sprintf("%d", len(slice))
        for i, item := range slice {
            newKey := fmt.Sprintf("%s.%d", prefix, i)
            flatten(newKey, item, flatmap)
        }
        return
    }

    // 基础类型（string, int, bool, float64 等）→ 直接转为字符串存储
    flatmap[prefix] = fmt.Sprintf("%v", value)
}