Go Academy · 课时

什么是结构体标签

Q: 「什么是结构体标签」这节课中我会学到什么？

为字段附加元数据 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

为字段附加元数据

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

什么是结构体标签

结构体标签是附加在结构体字段上的元数据字符串。它不会影响字段的值，但会向读取它的库传递指令。

标签语法

标签位于字段类型之后，并用原始字符串引号包围。每个标签都是一个 key:"value" 对。多个标签对之间以空格分隔。

典型的标签如下：json:"name"。

带标签的结构体

这里的字段带有一个 json 标签，告诉编码器使用小写的键名。

package main

import "fmt"

type User struct {
	Name string "json:\"name\""
}

func main() {
	u := User{Name: "Ann"}
	fmt.Println(u.Name)
}

标签只是元数据

标签不会改变代码使用字段的方式。u.Name 仍然可以正常工作。标签只对通过反射检查它们的库有意义。

一个字段上的多个标签

一个字段可以包含多个标签键，每个键由不同的库使用。

package main

import "fmt"

type Product struct {
	Name string "json:\"name\" db:\"product_name\""
}

func main() {
	p := Product{Name: "Pen"}
	fmt.Println(p.Name)
}

常见的标签键

常用的标签键包括：

json - JSON 编码
xml - XML 编码
db - 数据库列映射
validate - 验证规则

通过反射读取标签

reflect 包可以让您在运行时读取标签。field.Tag.Get("json") 会返回 json 键对应的值。

package main

import (
	"fmt"
	"reflect"
)

type User struct {
	Name string "json:\"name\""
}

func main() {
	t := reflect.TypeOf(User{})
	f := t.Field(0)
	fmt.Println(f.Tag.Get("json"))
}

Tag.Get 方法

Tag.Get(key) 返回某个键对应的值；如果键不存在，则返回空字符串。Tag.Lookup(key) 还会报告该键是否存在。

package main

import (
	"fmt"
	"reflect"
)

type User struct {
	Name string "json:\"name\""
}

func main() {
	f := reflect.TypeOf(User{}).Field(0)
	val, ok := f.Tag.Lookup("json")
	fmt.Println(val, ok)
}

标签格式约定

标准标签格式是 key:"value"，冒号两侧不能有空格。库会按照这一约定读取标签。格式错误的标签可能会被静默忽略。

为什么使用标签

标签可以让您将映射规则放在所描述的字段旁边，而不是放在单独的配置中。一个结构体可以在标签的驱动下，同时服务于 JSON 输出、数据库行和验证。

未导出字段上的标签

未导出字段（小写字段）上的标签可以通过反射看到，但大多数编码器会完全跳过未导出字段。需要序列化的字段请保持为已导出字段（首字母大写）。

快速检查

结构体标签的作用是什么？

回顾

结构体标签：

以 key:"value" 的形式附加在字段上
不影响普通代码；通过反射读取
由 json、xml、db、validate 等使用

常见问题解答

「什么是结构体标签」课时是免费的吗？

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

「什么是结构体标签」这节课中我会学到什么？

为字段附加元数据你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗？

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

「什么是结构体标签」课时需要多长时间？

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

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

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

此课程中的所有课时

← 返回 Go Academy