Golang反射遍历结构体字段技巧

本篇文章给大家分享《Golang反射遍历结构体字段方法》，覆盖了Golang的常见基础知识，其实一个语言的全部知识点一篇文章是不可能说完的，但希望通过这些问题，让读者对自己的掌握程度有一定的认识(B 数)，从而弥补自己的不足，更好的掌握它。

在 Golang 中，使用 reflect 包可动态遍历结构体字段。1. 通过 reflect.TypeOf 获取结构体类型，结合 .NumField() 和 .Field(i) 遍历字段名；2. 使用 field.Tag.Get("json") 可读取字段标签；3. 对匿名或嵌套结构体需递归处理以深入遍历；4. 注意避免访问未导出字段以防止 panic。此方法常用于 ORM、配置解析等场景。

在 Golang 中，反射（reflect）包提供了强大的能力来动态处理变量，尤其是当我们需要遍历结构体字段时，反射几乎是唯一的选择。但刚接触的朋友可能会觉得有点绕，下面我们就来看看怎么用反射来遍历结构体的字段。

获取结构体类型信息

要遍历结构体字段，首先得拿到它的类型信息。Go 的 reflect.TypeOf 函数可以获取一个变量的类型，如果这个变量是结构体，我们就可以通过 .NumField() 和 .Field(i) 方法来逐个访问字段。

举个例子：

type User struct {
    Name string
    Age  int
}

u := User{}
t := reflect.TypeOf(u)
for i := 0; i < t.NumField(); i++ {
    field := t.Field(i)
    fmt.Println(field.Name)
}

上面这段代码会输出结构体中每个字段的名字：Name 和 Age。这里的关键是先拿到结构体的类型对象，然后通过索引一个个取出来。

注意：如果你传入的是结构体指针，比如 &User{}，那么 reflect.TypeOf 返回的是 *User 类型，这时候需要用 .Elem() 来获取它指向的结构体类型。

遍历字段标签（Tag）

很多时候我们不仅想知道字段名，还想读取字段上的标签（tag），比如 JSON 序列化时使用的 json:"name"。这些信息也可以通过反射拿到。

继续上面的例子：

for i := 0; i < t.NumField(); i++ {
    field := t.Field(i)
    tag := field.Tag.Get("json")
    fmt.Printf("字段名：%s, json tag：%s\n", field.Name, tag)
}

这样你就能看到每个字段对应的 JSON 标签了。如果没有设置该标签，返回的就是空字符串。

常见用途包括 ORM 映射、配置解析、自动生成文档等场景。

处理匿名字段和嵌套结构体

结构体里可能会包含匿名字段或者嵌套结构体，这种情况下默认的遍历方式不会递归进去。如果你想“深入”查看所有字段，就需要自己写一层递归逻辑。

比如：

func walkFields(t reflect.Type) {
    for i := 0; i < t.NumField(); i++ {
        field := t.Field(i)
        if field.Anonymous && field.Type.Kind() == reflect.Struct {
            walkFields(field.Type)
        } else {
            fmt.Println(field.Name)
        }
    }
}

这样即使遇到嵌套结构体，也能把里面的字段都遍历出来。

这个技巧在实现通用工具函数时非常有用，比如数据校验器、自动填充器等。

基本上就这些。反射虽然强大，但也容易出错，比如访问未导出字段（小写开头）会导致 panic，所以在实际使用中要注意字段是否可导出。掌握好这几种方法，就能应对大多数结构体字段遍历的场景了。

理论要掌握，实操不能落！以上关于《Golang反射遍历结构体字段技巧》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！