0

0

如何使用 Golang 反射遍历结构体字段_Golang 动态字段扫描实战

P粉602998670

P粉602998670

发布时间:2025-11-12 18:41:35

|

295人浏览过

|

来源于php中文网

原创

使用反射可动态获取结构体字段信息并修改值,需传入指针且字段导出。1. 通过reflect.ValueOf和reflect.TypeOf获取值与类型;2. 调用.Elem()解指针;3. 遍历字段读取名称、类型、标签;4. 用Field(i)获取字段值,Type().Field(i)获取元信息;5. 通过Tag.Get读取json等标签;6. field.Set修改可导出字段值;7. 处理嵌套结构体需递归遍历。示例实现字段检查、字符串清空与深度遍历,适用于序列化、校验等场景。

如何使用 golang 反射遍历结构体字段_golang 动态字段扫描实战

在 Golang 中,结构体字段通常是静态定义的,但有时我们需要在运行时动态获取字段信息,比如做序列化、配置映射、数据校验等。这时就要用到反射(reflect)。通过反射,我们可以遍历结构体字段,读取字段名、类型、标签,甚至修改字段值。

使用 reflect 遍历结构体字段的基本步骤

要遍历结构体字段,核心是使用 reflect.ValueOfreflect.TypeOf 获取对象的类型和值信息。注意:如果要修改字段,传入的必须是指针,并且字段需为导出字段(首字母大写)。

基本流程如下:

  • 传入结构体指针,使用 reflect.ValueOf 获取其反射值
  • 调用 .Elem() 获取指针指向的实际值
  • 使用 .Type() 获取结构体类型信息
  • 通过 .NumField() 获取字段数量,再循环遍历每个字段
  • 使用 .Field(i) 获取字段值,.Type().Field(i) 获取字段元信息

读取字段名、类型与标签

结构体标签(struct tag)常用于标记 JSON 名称、数据库列名等。反射可以提取这些标签内容。

立即学习go语言免费学习笔记(深入)”;

示例代码:

package main

import (
    "fmt"
    "reflect"
)

type User struct {
    Name string `json:"name" validate:"required"`
    Age  int    `json:"age" validate:"min=0"`
    Email string `json:"email,omitempty"`
}

func inspectStruct(s interface{}) {
    v := reflect.ValueOf(s).Elem()
    t := v.Type()

    for i := 0; i < v.NumField(); i++ {
        field := v.Field(i)
        structField := t.Field(i)

        fmt.Printf("字段名: %s\n", structField.Name)
        fmt.Printf("字段类型: %s\n", field.Type())
        fmt.Printf("字段值: %v\n", field.Interface())

        if jsonTag := structField.Tag.Get("json"); jsonTag != "" {
            fmt.Printf("JSON 标签: %s\n", jsonTag)
        }

        if validateTag := structField.Tag.Get("validate"); validateTag != "" {
            fmt.Printf("校验规则: %s\n", validateTag)
        }
        fmt.Println("---")
    }
}

func main() {
    user := User{Name: "Alice", Age: 30, Email: "alice@example.com"}
    inspectStruct(&user)
}

输出结果会显示每个字段的名称、类型、当前值以及 json 和 validate 标签内容。

动态修改结构体字段值

反射不仅可以读取字段,还能在运行时修改字段值,前提是该字段可寻址且可设置(exported)。

百度文心一格
百度文心一格

百度推出的AI绘画作图工具

下载

示例:将所有字符串字段清空

func clearStringFields(s interface{}) {
    v := reflect.ValueOf(s).Elem()

    for i := 0; i < v.NumField(); i++ {
        field := v.Field(i)
        if field.Kind() == reflect.String {
            field.Set(reflect.Zero(field.Type()))
        }
    }
}

// 调用
user := User{Name: "Bob", Age: 25, Email: "bob@example.com"}
clearStringFields(&user)
fmt.Printf("%+v\n", user) // {Name: Age:25 Email:}

这里使用 field.Set() 修改值,reflect.Zero() 获取对应类型的零值。

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

如果结构体包含嵌套结构或匿名字段,需要递归遍历。可以通过检查字段是否为结构体类型来决定是否深入。

简单示例:

func walkStruct(v reflect.Value) {
    if v.Kind() == reflect.Ptr {
        v = v.Elem()
    }

    for i := 0; i < v.NumField(); i++ {
        field := v.Field(i)
        if field.Kind() == reflect.Struct {
            walkStruct(field) // 递归处理嵌套结构体
        } else {
            fmt.Printf("%s = %v\n", v.Type().Field(i).Name, field.Interface())
        }
    }
}

这样可以深度扫描整个结构体树形结构。

基本上就这些。Golang 反射虽然不如其他语言灵活,但在配置解析、ORM 映射、API 序列化等场景非常实用。关键是理解 ValueType区别,以及指针和可设置性的要求。用好反射,能让代码更通用、更自动化。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

178

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

226

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

337

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

208

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

388

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

194

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

189

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

192

2025.06.17

Java 项目构建与依赖管理(Maven / Gradle)
Java 项目构建与依赖管理(Maven / Gradle)

本专题系统讲解 Java 项目构建与依赖管理的完整体系,重点覆盖 Maven 与 Gradle 的核心概念、项目生命周期、依赖冲突解决、多模块项目管理、构建加速与版本发布规范。通过真实项目结构示例,帮助学习者掌握 从零搭建、维护到发布 Java 工程的标准化流程,提升在实际团队开发中的工程能力与协作效率。

10

2026.01.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.2万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号