本文介绍如何使用 Go 的 reflect 包递归遍历结构体字段，自动展开嵌套的 struct 类型，生成层次化类型视图，适用于逆向分析、代码理解与文档生成等场景。
本文介绍如何使用 go 的 `reflect` 包递归遍历结构体字段，自动展开嵌套的 struct 类型，生成层次化类型视图，适用于逆向分析、代码理解与文档生成等场景。
在 Go 项目逆向工程或阅读他人代码时，常需快速理清复杂嵌套结构体的实际组成。例如，当遇到 type Foo struct { z Bar } 时，仅看定义无法直接获知 Bar 的字段；若手动逐层查阅，效率低下且易遗漏。此时，借助反射（reflect）可自动化完成结构体的递归展开，清晰呈现每一级字段及其底层类型。
以下是一个轻量、可复用的实现方案：
package main
import (
"fmt"
"reflect"
)
func printFields(prefix string, t reflect.Type) {
for i := 0; i < t.NumField(); i++ {
f := t.Field(i)
// 打印字段名与类型（简化包路径，提升可读性）
typeName := f.Type.String()
if f.Type.PkgPath() != "" {
typeName = f.Type.Name() // 优先显示未导出类型名（如 Bar），避免冗长的 "main.Bar"
}
fmt.Printf("%s%v %s\n", prefix, f.Name, typeName)
// 若字段为结构体，则递归展开
if f.Type.Kind() == reflect.Struct {
printFields(prefix+" ", f.Type)
}
}
}
func PrintExpandedStruct(s interface{}) {
t := reflect.TypeOf(s)
if t.Kind() == reflect.Ptr {
t = t.Elem()
}
if t.Kind() == reflect.Struct {
printFields("", t)
} else {
fmt.Printf("expected struct or *struct, got %v", t.Kind())
}
}
// 示例结构体
type Bar struct {
a int
b string
}
type Foo struct {
x int
y []string
z Bar
w *Baz // 支持指针嵌套
}
type Baz struct {
c bool
}
func main() {
PrintExpandedStruct(Foo{})
}运行后输出如下（已优化可读性）：
x int y []string z Bar a int b string w *Baz c bool
✅ 关键特性说明：
- 自动处理嵌套
struct、*struct、基础类型、切片、映射等常见类型； - 使用缩进体现嵌套层级，直观反映结构深度；
- 对非导出字段（如
a,b）仍可反射访问（需值为具体实例，但TypeOf已足够）； - 支持指针类型展开（如
*Baz→ 展开Baz字段）； - 通过
PkgPath()判断是否为命名类型，避免冗余包前缀（如main.Bar→Bar）。
⚠️ 注意事项：
- 反射无法获取未导出字段的实际值（但本例仅需类型信息，
reflect.Type完全可用）； - 循环引用结构体（如
A包含*B，B包含*A）将导致无限递归——生产环境建议添加深度限制或已访问类型缓存； - 此方案适用于编译期已知结构，不适用于运行时动态构造的匿名 struct（因无名称，仅能打印
struct{...}）。
该方法无需外部工具或代码生成器，纯标准库实现，可轻松集成至调试脚本、CLI 工具或 IDE 插件中，是 Go 开发者深入理解遗留代码结构的实用利器。
