递归打印任意嵌套结构体需用 reflect.Value 判断 Kind、解引用指针/interface{}、遍历 struct/map/slice,并限制深度(如 >5 时输出“…”)防止无限循环。

要用 go 的 reflect 递归打印任意嵌套结构体(包括 map、slice、指针、interface{} 等),关键在于:判断类型、解引用、递归进入子值,并控制深度避免无限循环。
基础思路:用 reflect.Value 逐层展开
Go 反射的核心是 reflect.Value 和 reflect.Type。对任意值调用 reflect.ValueOf(v) 后,可检查其种类(kind()),再根据种类决定如何继续访问:
- 指针:用
.Elem()解引用(需确保非空) - 结构体:遍历字段(
.NumField()+.Field(i)),注意导出性(仅导出字段可读) - 切片/数组:用
.len()和.Index(i)遍历元素 - map:用
.MapKeys()获取 key 列表,再用.MapIndex(key)取 value - Interface{}:用
.Elem()拆包后继续处理(本质是隐式指针) - 基本类型(int/String/bool等):直接打印
.Interface()
防止无限递归:加深度限制和地址去重
遇到循环引用(如 Struct A 包含 *A)或深层嵌套时,不加保护会 panic 或卡死。推荐两种方式:
- 深度计数:每进一层递归 +1,超过阈值(如 10)就停止深入,改打
"..." - 地址缓存:用
map[uintptr]bool记录已访问的Value.UnsafeAddr()(仅对可寻址值有效),跳过重复项;对不可寻址值(如 map value、函数返回值)可忽略此检查
代码示例:简洁可运行的递归打印函数
以下是一个带缩进、深度限制、安全解引用的实现:
立即学习“go语言免费学习笔记(深入)”;
func PrintValue(v interface{}, depth int) { if depth > 5 { fmt.Print("...") return } rv := reflect.ValueOf(v) if !rv.IsValid() { fmt.Print("nil") return } <pre class="brush:php;toolbar:false;">// 处理指针:解引用并加 * if rv.Kind() == reflect.Ptr { if rv.IsNil() { fmt.Print("nil") return } fmt.Print("*") PrintValue(rv.Elem().Interface(), depth+1) return } // 处理 interface{}:递归其底层值 if rv.Kind() == reflect.Interface { if rv.IsNil() { fmt.Print("nil") return } PrintValue(rv.Elem().Interface(), depth+1) return } // 基本类型直接输出 switch rv.Kind() { case reflect.String, reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64, reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Float32, reflect.Float64, reflect.Bool, reflect.Complex64, reflect.Complex128: fmt.Print(rv.Interface()) case reflect.Struct: fmt.Print("{") for i := 0; i < rv.NumField(); i++ { if i > 0 { fmt.Print(" ") } field := rv.Field(i) name := rv.Type().Field(i).Name fmt.Print(name, ":") PrintValue(field.Interface(), depth+1) } fmt.Print("}") case reflect.Slice, reflect.Array: fmt.Print("[") for i := 0; i < rv.Len(); i++ { if i > 0 { fmt.Print(" ") } PrintValue(rv.Index(i).Interface(), depth+1) } fmt.Print("]") case reflect.Map: fmt.Print("map[") for i, key := range rv.MapKeys() { if i > 0 { fmt.Print(" ") } PrintValue(key.Interface(), depth+1) fmt.Print(":") PrintValue(rv.MapIndex(key).Interface(), depth+1) } fmt.Print("]") default: fmt.Print(rv.Kind()) }
}
调用方式:PrintValue(yourStruct, 0)。支持嵌套 struct、[]struct、map[string]interface{}、*T 等常见组合。
实用建议:调试时更友好地显示字段名和类型
真实调试中,光看值不够,常需知道字段名、类型甚至 tag。可在打印结构体字段时补充类型信息:
- 用
rv.Type().Field(i).Type.String()获取字段类型名 - 用
rv.Type().Field(i).Tag.Get("json")打印 json tag(适合对比序列化行为) - 对 slice/map 元素,可统一加括号标注类型,如
[]int{1 2}→[](int){1 2}
不复杂但容易忽略。