Go Academy · 课时

JSON 标签

Q: 「JSON 标签」这节课中我会学到什么？

控制编解码 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

控制编解码

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

JSON 标签控制编码

encoding/json 包使用 json 标签来决定结构体转换为 JSON 或从 JSON 转换时的键名和规则。

默认字段名

没有标签时，JSON 键会完全匹配已导出字段的名称，包括大小写。

package main

import (
	"encoding/json"
	"fmt"
)

type User struct {
	Name string
	Age  int
}

func main() {
	b, _ := json.Marshal(User{"Ann", 30})
	fmt.Println(string(b))
}

重命名键

json 标签会更改输出中的键名。在这里，Name 会变成小写的 name。

package main

import (
	"encoding/json"
	"fmt"
)

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

func main() {
	b, _ := json.Marshal(User{"Ann", 30})
	fmt.Println(string(b))
}

omitempty 选项

添加 ,omitempty 后，如果字段保存的是零值（空字符串、0、nil 等），就会在输出中跳过该字段。

package main

import (
	"encoding/json"
	"fmt"
)

type User struct {
	Name  string "json:\"name\""
	Email string "json:\"email,omitempty\""
}

func main() {
	b, _ := json.Marshal(User{Name: "Ann"})
	fmt.Println(string(b))
}

忽略字段

值为 - 的标签会告诉编码器完全跳过该字段，适合用于密码等机密信息。

package main

import (
	"encoding/json"
	"fmt"
)

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

func main() {
	b, _ := json.Marshal(User{"Ann", "secret"})
	fmt.Println(string(b))
}

使用标签进行解码

标签在两个方向上都有效。解码 JSON 时，标签会告诉解码器哪个 JSON 键应填入哪个字段。

package main

import (
	"encoding/json"
	"fmt"
)

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

func main() {
	var u User
	json.Unmarshal([]byte("{\"name\":\"Bob\"}"), &u)
	fmt.Println(u.Name)
}

不区分大小写的匹配

解码时，作为备用匹配方式，Go 会以不区分大小写的方式将 JSON 键与标签进行匹配。不过，明确声明标签仍然是安全且清晰的选择。

string 选项

,string 选项会将数值或布尔字段编码为 JSON 字符串。对于要求数字带引号的系统，这一选项很有用。

package main

import (
	"encoding/json"
	"fmt"
)

type Item struct {
	ID int "json:\"id,string\""
}

func main() {
	b, _ := json.Marshal(Item{ID: 42})
	fmt.Println(string(b))
}

组合选项

您可以将名称与选项组合起来：json:"email,omitempty"。名称位于最前面，后面跟着以逗号分隔的选项。

跳过未导出字段

只有已导出字段（首字母大写）会被编码。无论带有什么标签，小写字段对 encoding/json 都不可见。

package main

import (
	"encoding/json"
	"fmt"
)

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

func main() {
	b, _ := json.Marshal(User{Name: "Ann", age: 30})
	fmt.Println(string(b))
}

美化输出

json.MarshalIndent 会使用缩进格式化 JSON，便于生成易读的日志，同时仍会遵循标签。

package main

import (
	"encoding/json"
	"fmt"
)

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

func main() {
	b, _ := json.MarshalIndent(User{"Ann"}, "", "  ")
	fmt.Println(string(b))
}

快速检查

,omitempty 选项在 json 标签中有什么作用？

回顾

JSON 标签用于控制序列化：

使用 json:"name" 重命名键
,omitempty 会跳过零值
- 会忽略字段；,string 会将数字加引号
只有导出字段会被编码

常见问题解答

「JSON 标签」课时是免费的吗？

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

「JSON 标签」这节课中我会学到什么？

控制编解码你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗？

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

「JSON 标签」课时需要多长时间？

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

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

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

此课程中的所有课时

← 返回 Go Academy