本文介绍使用 gopkg.in/yaml.v2 解析 YAML 后，通过反射（reflect）递归遍历嵌套结构（map、slice、scalar）并打印所有键值对的完整方法，适用于任意深度的 YAML 数据。
本文介绍使用 `gopkg.in/yaml.v2` 解析 yaml 后，通过反射（`reflect`）递归遍历嵌套结构（map、slice、scalar）并打印所有键值对的完整方法，适用于任意深度的 yaml 数据。
在 Go 中处理 YAML 配置文件时，常需动态探查其结构并提取所有键值——尤其是当 YAML 具有深层嵌套的 map 和 slice（如配置列表、多级参数等）时。由于 YAML 的灵活性，Go 无法在编译期确定结构，因此推荐先反序列化为通用类型 map[string]interface{} 或 map[interface{}]interface{}，再结合 reflect 包进行类型判断与递归遍历。
核心思路是：
- 使用 yaml.Unmarshal 将 YAML 字节流解析为顶层 map[string]interface{}；
- 对每个值调用递归函数，依据其运行时类型（reflect.Kind）分发处理逻辑：
- string / int / bool / float64 等基础类型 → 直接打印；
- map[interface{}]interface{} → 遍历键值对，递归处理每个 value；
- []interface{} → 遍历切片元素，递归处理每个 item；
- 利用缩进（strings.Repeat(" ", depth)）增强输出可读性，直观反映嵌套层级。
以下为完整可运行示例：
package main
import (
"fmt"
"gopkg.in/yaml.v2"
"reflect"
"strings"
)
var data = `
Data:
- name: "foo"
bar1: 0
k1: val1
k2:
- val2
- val3
bar2: 1
k3: val4
k4: val5
k5: val5
k6: val6
`
func printVal(v interface{}, depth int) {
rv := reflect.ValueOf(v)
rk := reflect.TypeOf(v).Kind()
// 处理基础标量类型
if rk == reflect.String || rk == reflect.Int || rk == reflect.Int64 ||
rk == reflect.Float64 || rk == reflect.Bool || rk == reflect.Interface {
fmt.Printf("%s%v\n", strings.Repeat(" ", depth), rv.Interface())
return
}
// 处理 map 类型（YAML object）
if rk == reflect.Map {
m := v.(map[interface{}]interface{})
for k, val := range m {
keyStr := fmt.Sprintf("%v", k)
fmt.Printf("%sKey: %s\n", strings.Repeat(" ", depth), keyStr)
printVal(val, depth+1)
}
return
}
// 处理 slice 类型（YAML array / list）
if rk == reflect.Slice {
s := rv.Len()
for i := 0; i \n", strings.Repeat(" ", depth), rk, rv.Interface())
}
func main() {
var m map[string]interface{}
err := yaml.Unmarshal([]byte(data), &m)
if err != nil {
panic(fmt.Sprintf("YAML unmarshal error: %v", err))
}
for k, v := range m {
fmt.Printf("Root Key: %s\n", k)
printVal(v, 1)
}
}
⚠️ 注意事项：
- YAML 中重复 key（如示例中多次出现 k3/k4）会被后写入值覆盖，这是 YAML 规范行为，Go 解析器不报错但仅保留最后一个；
- 若需严格校验或保留所有字段，建议定义结构体（struct）配合 yaml:"key_name" tag 显式控制映射；
- map[interface{}]interface{} 更贴近 YAML 原生语义（key 可为非 string），但 map[string]interface{} 更常用且类型安全；若 YAML key 非字符串，需改用前者并做类型断言；
- 生产环境建议添加空值（nil）和循环引用防护（本例未展开，可通过 reflect.Value 的 IsNil() 及访问路径缓存实现）。
该方法轻量、无依赖、兼容性强，是调试 YAML 结构、构建通用配置探查工具或实现动态模板渲染的理想起点。
