本文详解 Go 中使用 gopkg.in/yaml.v2 反序列化含嵌套切片的 YAML 到结构体时常见的 reflect: Value.Set using unaddressable value panic 错误，核心在于必须传入结构体指针而非值类型。
本文详解 go 中使用 gopkg.in/yaml.v2 反序列化含嵌套切片的 yaml 到结构体时常见的 `reflect: value.set using unaddressable value` panic 错误，核心在于必须传入结构体指针而非值类型。
在 Go 中使用 yaml.Unmarshal 解析 YAML 配置时，若目标结构体包含多层嵌套切片（如 []FileInstance、[]RegexInstance 等），最常见的崩溃原因是
未向 Unmarshal 传递可寻址的结构体指针
。YAML 解析器依赖反射动态设置字段值，而 Go 的反射要求目标值必须是可寻址的（即需通过指针访问）；若传入结构体值（如 Configuration{}），Unmarshal 实际操作的是该值的副本，无法修改原始变量，最终触发 reflect: reflect.Value.Set using unaddressable value panic。
正确的做法是始终确保 Unmarshal 接收一个指向已初始化结构体的指针。以下是推荐的两种等效写法：
⚠️
常见错误示例（会导致 panic）
：
此外，结构体字段需满足 YAML 反序列化的基本要求：
字段名首字母
必须大写
（即导出字段），否则无法被反射访问；
可选地添加 yaml:"key_name" 标签以精确匹配 YAML 键（如 File stringyaml:"file"`）；
切片字段（如 []FileInstance）无需特殊处理，只要类型定义正确且结构体可寻址，gopkg.in/yaml.v2 会自动分配并填充底层数组。
完整可运行示例（含错误处理）：
总结：解决 GoYAML 切片反序列化 panic 的关键仅有一条——
永远传指针，且该指针必须指向一个已分配内存的有效结构体实例
。结合清晰的结构体设计与严谨的错误检查，即可稳健解析任意深度的 YAML 嵌套列表结构。
// ✅ 方式一：声明并取地址（推荐，语义清晰）
var config Configuration
err := yaml.Unmarshal(data, &config)
if err != nil {
log.Fatal("YAML unmarshal failed:", err)
}
// ✅ 方式二：直接声明指针并初始化
config := &Configuration{}
err := yaml.Unmarshal(data, config) // 注意：此处 config 已是 *Configuration 类型
if err != nil {
log.Fatal("YAML unmarshal failed:", err)
}// ❌ 错误：c 是值类型，&c 虽为指针，但若 c 未初始化或为 nil 指针则仍失败
var c *Configuration
yaml.Unmarshal(data, c) // panic: nil pointer dereference
// ❌ 错误：传入值类型副本，Unmarshal 无法修改原始变量
c := Configuration{}
yaml.Unmarshal(data, c) // panic: reflect.Value.Set using unaddressable valuepackage main
import (
"fmt"
"log"
"gopkg.in/yaml.v2"
)
func main() {
yamlData := `
input:
file:
- file: stdin
webservice:
- port: "8080"
address: 127.0.0.1
processing:
regex:
- regex: ^[a-z]+
mapping: lowercase_word
output:
file:
- file: stdout
webservice:
- port: "9000"
address: ::1
`
var cfg Configuration
if err := yaml.Unmarshal([]byte(yamlData), &cfg); err != nil {
log.Fatal("Failed to parse YAML:", err)
}
fmt.Printf("Parsed %d input files, %d regex rules\n",
len(cfg.Input.File),
len(cfg.Processing.Regex))
}