Golang反射实战：实现一个通用的打印工具 Go语言递归格式化输出-Golang-PHP中文网

fmt.printf("%+v") 不够用，因其输出单行无缩进、字段顺序不定、无法处理未导出字段panic、循环引用及不可寻址值；需用 reflect.value 手动遍历，严格检查 nil、caninterface、canaddr，并缓存地址防循环。

golang反射实战：实现一个通用的打印工具 go语言递归格式化输出

因为它的输出是单行、无缩进、字段顺序不固定，嵌套深时根本没法看；更麻烦的是，它不会跳过未导出字段的 panic（比如 struct 里有 sync.Mutex），也不会处理循环引用——一碰到就直接崩溃。

真实调试场景下，你真正需要的是：能展开、可读、安全、带类型提示的递归打印。这不是格式化问题，是反射控制权的问题。

必须用 reflect.Value 手动遍历，不能依赖 fmt 默认行为
要主动检查 CanInterface() 和 CanAddr()，否则对不可寻址值（如 map value、函数返回的临时 struct）会 panic
循环引用必须靠地址缓存识别，光比值没用——reflect.Value 的 Pointer() 在非指针类型上返回 0，得统一转成 unsafe.Pointer 再判重

Go 反射里最常崩的地方，就是把 nil 接口或空指针当正常值去 .Elem()。必须分三步走：先判断是否为 nil，再判断能否解引用，最后才取值。

对 reflect.Interface 类型：先用 v.IsNil() 判空，再用 v.Elem() 获取底层值（注意不是 v.Interface()）
对 reflect.Ptr 类型：同样先 v.IsNil()，再 v.Elem()；但若原值是 *int 且为 nil，v.Elem() 会 panic，所以必须前置检查
对 map/slice/channel：它们本身可为 nil，v.Len() 在 nil 值上返回 0，但 v.MapKeys() 或 v.Index(0) 会 panic，必须先 v.IsValid() && !v.IsNil()

示例片段：

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

if v.Kind() == reflect.Ptr {
    if v.IsNil() {
        fmt.Print("nil")
        return
    }
    fmt.Print("*")
    printValue(v.Elem(), depth+1)
}

靠拼字符串容易错位，尤其嵌套深时 tab 和空格混用会让结构塌陷。实际做法是：每层用固定宽度缩进（比如 2 空格），字段名右对齐到统一列，类型用 v.Type().String() 但要去掉包路径前缀（否则 main.MyStruct 比 int 长太多，对不齐）。

用 strings.TrimPrefix(v.Type().String(), "main.") 简单去包名（生产环境建议缓存 reflect.Type 到 clean name 的 map）
字段名对齐宽度设为 24，超过就截断加 …，避免一行太长影响阅读节奏
基础类型（int、string、bool）直接打印值；复合类型（struct、map）才换行 + 缩进 + 展开

不是所有 Go 值都能“安全反射”。以下几类不处理就会 panic 或输出无意义内容：

func 类型：反射后 v.Kind() == reflect.Func，但 v.Call() 需参数，不能随便调，只能打印 "func(...)"
unsafe.Pointer、uintptr：reflect 不支持直接取值，打印地址值（v.UnsafePointer()）即可
reflect.Value 自身：如果用户传入的是 reflect.Value，要防止无限递归，检测 v.Type() == reflect.TypeOf(reflect.Value{}) 就停
channel、mutex 等同步原语：它们内部含不可复制字段，v.CanInterface() 返回 false，必须用 v.Kind() 分支单独打桩