Go Academy · 课时

检查结构体字段与标签

遍历字段并读取结构体标签

第 2 / 4 课13 个步骤

检查结构体字段与标签 是 CoddyKit 上的免费 Go Academy 课时。 这是第 2 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Go Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。

StructField 类型

reflect.StructField 描述结构体的一个字段:Name、Type、Tag、Index、Offset、Anonymous 和 IsExported。

遍历字段

遍历结构体类型的所有字段:

t := reflect.TypeOf(struct{ ID int; Name string }{})
for i := 0; i < t.NumField(); i++ {
    f := t.Field(i)
    fmt.Println(f.Name, f.Type, f.IsExported())
}

读取结构体标签

通过 StructField.Tag.Get("key") 访问标签:

type User struct {
    ID   int    `json:"id" db:"user_id"`
    Name string `json:"name,omitempty"`
}

f, _ := reflect.TypeOf(User{}).FieldByName("Name")
fmt.Println(f.Tag.Get("json")) // "name,omitempty"

解析标签选项

标签可能包含以逗号分隔的选项。请使用 strings.Split 进行解析:

tag := f.Tag.Get("json") // "name,omitempty"
parts := strings.Split(tag, ",")
name := parts[0] // "name"
omitempty := len(parts) > 1 && parts[1] == "omitempty"

FieldByName 与 FieldByIndex

按名称或索引查找字段。FieldByName 会在结构体及其嵌入结构体中搜索导出字段:

f, ok := reflect.TypeOf(User{}).FieldByName("Name")
if ok { fmt.Println(f.Tag.Get("json")) }

嵌入结构体字段

对于嵌入结构体,Anonymous 为 true。请使用 Type.FieldByIndex([]int{0,1}) 访问嵌套字段。

未导出字段

可以通过反射检查未导出(小写)字段的类型和标签,但无法读取或设置其值——否则会引发恐慌。

构建字段缓存

每次调用都解析结构体标签的成本很高。请将结果缓存到以 reflect.Type 为键的 sync.Map 中:

var fieldCache sync.Map
func getFields(t reflect.Type) []fieldInfo {
    if v, ok := fieldCache.Load(t); ok { return v.([]fieldInfo) }
    fields := parseFields(t)
    fieldCache.Store(t, fields)
    return fields
}

用例:简单 ORM

遍历所有带有 "db" 标签的字段,动态构建 INSERT 列表:

t := reflect.TypeOf(u)
v := reflect.ValueOf(u)
for i := 0; i < t.NumField(); i++ {
    col := t.Field(i).Tag.Get("db")
    val := v.Field(i).Interface()
    // build query...
}

用例:配置加载器

遍历带有 "env" 标签的结构体字段,并从环境变量中填充这些字段:

if env := f.Tag.Get("env"); env != "" {
    if val := os.Getenv(env); val != "" {
        v.Field(i).SetString(val)
    }
}

StructTag.Lookup

Tag.Lookup("key") 返回标签值和一个布尔值,用于指示该键是否存在(不同于 Get,后者会在键不存在时返回 "")。

val, ok := f.Tag.Lookup("json")
if !ok { /* no json tag */ }

快速检查

如何从 reflect.StructField 读取 "json" 结构体标签的值?

回顾:结构体字段与标签

要点:

  • reflect.TypeOf → .NumField()、.Field(i) 用于获取字段元数据
  • 使用 StructField.Tag.Get("key") 读取标签值
  • 将字段元数据缓存到 sync.Map 中,避免重复解析
  • 当需要区分缺失标签和空字符串时,使用 Tag.Lookup
免费开始

用 AI 导师学习 Go — 免费

在浏览器中编写并运行真实代码,获得全天候 AI 导师的即时帮助,并在网页或应用中继续学习。

课程
51
课程
203

常见问题解答

「检查结构体字段与标签」课时是免费的吗?

是的 — 「检查结构体字段与标签」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Go Academy 课程的其余内容,请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。

「检查结构体字段与标签」这节课中我会学到什么?

遍历字段并读取结构体标签 你通过在浏览器中直接运行的动手代码来练习 Go Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗?

无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 2 节课,共 4 节。

「检查结构体字段与标签」课时需要多长时间?

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。

我能在这节 Go Academy 课中编写并运行代码吗?

能。每节 Go Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. reflect.Type 与 reflect.Value
  2. 检查结构体字段与标签
  3. 动态函数调用
  4. 实用反射:序列化器
← 返回 Go Academy