JSON 编码与解码
Marshal、Unmarshal 与结构体标签
JSON 编码与解码 是 CoddyKit 上的免费 Go Academy 课时。 这是第 3 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。
encoding/json 概览
Go 的 encoding/json 包使用结构体标签和反射，将 Go 值编码为 JSON，并将 JSON 解码回 Go 值。
json.Marshal
json.Marshal 会将 Go 值转换为 JSON 字节。对于不受支持的类型（通道、函数和复数），它会返回错误。
type User struct {
Name string `json:"name"`
Age int `json:"age"`
}
u := User{Name: "Alice", Age: 30}
data, err := json.Marshal(u)
fmt.Println(string(data)) // {"name":"Alice","age":30}json.Unmarshal
json.Unmarshal 会将 JSON 解码为 Go 值。目标必须是指针。
var u User
err := json.Unmarshal(data, &u)
fmt.Println(u.Name) // "Alice"结构体标签
使用 json: 结构体标签来控制字段名称、忽略空值以及跳过未导出字段。
type Product struct {
ID int `json:"id"`
Price float64 `json:"price,omitempty"` // omit if zero
secret string // unexported: ignored
}json.Encoder / json.Decoder
对于流式处理（HTTP 响应正文和请求正文），请使用 Encoder 和 Decoder，而不是 Marshal/Unmarshal，以避免将整个载荷加载到内存中。
// Writing
json.NewEncoder(w).Encode(user)
// Reading
var u User
json.NewDecoder(r.Body).Decode(&u)解码到 map[string]any
将未知的 JSON 解码到通用映射中：
var m map[string]any
json.Unmarshal(data, &m)
fmt.Println(m["name"])json.Number
默认情况下，通用映射中的数字会被解码为 float64。使用 decoder.UseNumber() 可将其解码为保留精度的 json.Number。
dec := json.NewDecoder(r)
dec.UseNumber()
var m map[string]any
dec.Decode(&m)自定义编码
实现 json.Marshaler 或 json.Unmarshaler，即可控制某种类型的编码和解码，例如自定义日期格式。
func (d Date) MarshalJSON() ([]byte, error) {
return json.Marshal(d.Format("2006-01-02"))
}省略字段
使用 omitempty 跳过零值。使用 json:"-" 可始终将字段排除在 JSON 输出之外，无论其值是什么。
Hidden string `json:"-"`处理 null
JSON null 解码为标量类型的 Go 零值，或将指针设置为 nil。将 nil 指针编码为 null。
美化输出
使用 json.MarshalIndent 生成便于人类阅读的输出：
data, _ := json.MarshalIndent(u, "", " ")快速检查
结构体标签 `json:"name,omitempty"` 的作用是什么？
回顾：JSON 编码与解码
关键要点：
- json.Marshal/Unmarshal 用于内存数据；Encoder/Decoder 用于流
- 结构体标签控制名称、omitempty 和字段排除
- 自定义类型实现 Marshaler/Unmarshaler
- 使用 json.MarshalIndent 生成调试输出
用 AI 导师学习 Go — 免费
在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。
- 课程
- 51
- 课程
- 203
常见问题解答
「JSON 编码与解码」课时是免费的吗？
是的 — 「JSON 编码与解码」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。
「JSON 编码与解码」这节课中我会学到什么？
Marshal、Unmarshal 与结构体标签 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Go Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 4 节。
「JSON 编码与解码」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Go Academy 课中编写并运行代码吗？
能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。