当前位置：首页 > 文章列表 > Golang > Go教程 > Golang结构体字段名获取方法详解

Golang结构体字段名获取方法详解

2026-01-17 23:58:34 0浏览收藏

怎么入门Golang编程？需要学习哪些知识点？这是新手们刚接触编程时常见的问题；下面golang学习网就来给大家整理分享一些知识点，希望能够给初学者一些帮助。本篇文章就来介绍《Golang获取结构体字段名方法解析》，涉及到，有需要的可以收藏一下

在Golang中通过reflect.TypeOf获取结构体字段名，遍历Field即可输出Name、Age、Email；2. 只能访问导出字段（首字母大写），未导出字段信息受限；3. 结合struct tag可提取json等元信息；4. 反射性能低，避免高频使用，需确保传入结构体类型。

如何在Golang中获取结构体字段名称

在Golang中获取结构体字段名称，主要依赖反射（reflect）包。通过反射可以遍历结构体的字段信息，包括字段名、类型、标签等。下面介绍几种常用方法。

使用 reflect.TypeOf 获取字段名称

最直接的方式是使用 reflect.TypeOf 获取结构体类型，然后通过 NumField 和 Field 遍历所有字段。

示例代码：

package main

import (
    "fmt"
    "reflect"
)

type User struct {
    Name string
    Age  int
    Email string
}

func main() {
    var u User
    t := reflect.TypeOf(u)

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

输出结果：

Name
Age
Email

获取导出和未导出字段

Golang中只有导出字段（首字母大写）才能通过反射读取。如果结构体包含小写字母开头的字段，默认无法访问。

若尝试访问未导出字段，reflect 仍能获取字段名，但部分信息受限（如无法获取值，除非使用指针和可寻址对象）。

注意：未导出字段在反射中依然可见，但操作受限制。

结合结构体标签使用

实际开发中常配合结构体标签（struct tag）使用，比如 JSON 序列化。也可以从中提取字段别名或其他元信息。

示例：

type User struct {
    Name  string `json:"name"`
    Age   int    `json:"age"`
    Email string `json:"email"`
}

// 获取 json 标签名
for i := 0; i < t.NumField(); i++ {
    field := t.Field(i)
    jsonTag := field.Tag.Get("json")
    fmt.Printf("Field: %s, JSON Tag: %s\n", field.Name, jsonTag)
}