Go语言第十五章(JSON序列化)

作者:小满zs日期:2026/10/29

JSON 序列化与反序列化

写接口、存配置、跟前端或别的服务交换数据,几乎都会碰到 JSON。
Go 标准库 encoding/json 负责两件事:

  • 序列化(Marshal):把 Go 的值变成 JSON 字节([]byte)
  • 反序列化(Unmarshal):把 JSON 字节解析回 Go 的值

入门先记住五件事:

  1. 序列化用 json.Marshal,反序列化用 json.Unmarshal。
  2. 结构体字段必须导出(首字母大写),否则 JSON 里看不到。
  3. 用 json:"字段名" 标签控制 JSON 里的名字。
  4. omitempty 可以在「空值」时省略该字段。
  5. 反序列化时第二个参数必须是指针。

口诀:出站 Marshal,进站 Unmarshal;字段要大写,名字靠 tag。

序列化:Marshal

把结构体、map、切片等变成 JSON:

1package main
2
3import (
4	"encoding/json"
5	"fmt"
6)
7
8type Person struct {
9	Name string
10	Age  int
11	City string
12}
13
14func main() {
15	p := Person{Name: "小满", Age: 18, City: "杭州"}
16
17	data, err := json.Marshal(p)
18	if err != nil {
19		panic(err)
20	}
21
22	fmt.Println(string(data))
23	// {"Name":"小满","Age":18,"City":"杭州"}
24}
25
写法含义
json.Marshal(v)返回 []byte 和 error
string(data)把字节转成可读字符串
字段名默认用结构体字段名(如 Name)

想格式化(缩进、好看一点)用 MarshalIndent:

1data, err := json.MarshalIndent(p, "", "  ")
2if err != nil {
3	panic(err)
4}
5fmt.Println(string(data))
6

输出类似:

1{
2  "Name": "小满",
3  "Age": 18,
4  "City": "杭州"
5}
6

反序列化:Unmarshal

把 JSON 填进结构体。第二个参数必须是指针:

1package main
2
3import (
4	"encoding/json"
5	"fmt"
6)
7
8type Person struct {
9	Name string
10	Age  int
11	City string
12}
13
14func main() {
15	raw := []byte(`{"Name":"小满","Age":18,"City":"杭州"}`)
16
17	var p Person
18	err := json.Unmarshal(raw, &p) // 注意 &p
19	if err != nil {
20		panic(err)
21	}
22
23	fmt.Printf("%+v\n", p)
24	// {Name:小满 Age:18 City:杭州}
25}
26
写法含义
json.Unmarshal(data, &v)把 JSON 写入 v
必须传指针传值无法修改外部变量
JSON 多了字段默认忽略,不报错
JSON 少了字段对应字段保持零值

忘了写 & 会报错:json: Unmarshal(non-pointer ...)。

结构体标签(json tag)

接口里常见小写字段名(name、age),而 Go 导出字段必须大写。用 tag 对齐两边:

1package main
2
3import (
4	"encoding/json"
5	"fmt"
6)
7
8type Person struct {
9	Name string `json:"name"`
10	Age  int    `json:"age"`
11	City string `json:"city"`
12}
13
14func main() {
15	p := Person{Name: "小满", Age: 18, City: "杭州"}
16
17	data, _ := json.Marshal(p)
18	fmt.Println(string(data))
19	// {"name":"小满","age":18,"city":"杭州"}
20
21	var p2 Person
22	_ = json.Unmarshal([]byte(`{"name":"奶茶","age":20,"city":"上海"}`), &p2)
23	fmt.Printf("%+v\n", p2)
24	// {Name:奶茶 Age:20 City:上海}
25}
26

常用 tag 选项:

tag作用
`json:"name"`JSON 字段名用 name
`json:"name,omitempty"`空值时不输出该字段
`json:"-"`序列化/反序列化都忽略
`json:",omitempty"`保留字段名,只加 omitempty

omitempty

「空」的含义:0、""、false、nil、空切片/map 等零值。

1package main
2
3import (
4	"encoding/json"
5	"fmt"
6)
7
8type User struct {
9	Name   string   `json:"name"`
10	Age    int      `json:"age,omitempty"`
11	Tags   []string `json:"tags,omitempty"`
12	Secret string   `json:"-"` // 永远不出现在 JSON 里
13}
14
15func main() {
16	u := User{Name: "小满", Secret: "不要对外暴露"}
17	data, _ := json.Marshal(u)
18	fmt.Println(string(data))
19	// {"name":"小满"}
20	// Age=0、Tags=nil 被 omitempty 省略;Secret 被 - 忽略
21}
22

嵌套结构体

JSON 里经常有对象套对象,对应 Go 的嵌套结构体:

1package main
2
3import (
4	"encoding/json"
5	"fmt"
6)
7
8type Address struct {
9	City    string `json:"city"`
10	Street  string `json:"street"`
11}
12
13type Order struct {
14	ID      int     `json:"id"`
15	Product string  `json:"product"`
16	Addr    Address `json:"address"`
17}
18
19func main() {
20	o := Order{
21		ID:      1001,
22		Product: "芋泥波波",
23		Addr:    Address{City: "杭州", Street: "西湖路"},
24	}
25
26	data, _ := json.Marshal(o)
27	fmt.Println(string(data))
28	// {"id":1001,"product":"芋泥波波","address":{"city":"杭州","street":"西湖路"}}
29
30	raw := []byte(`{"id":1002,"product":"绿茶","address":{"city":"上海","street":"南京路"}}`)
31	var o2 Order
32	_ = json.Unmarshal(raw, &o2)
33	fmt.Printf("%+v\n", o2)
34}
35

map 与切片

不一定非要结构体,map 和切片也能直接编解码:

1package main
2
3import (
4	"encoding/json"
5	"fmt"
6)
7
8func main() {
9	// map → JSON
10	m := map[string]any{
11		"name": "小满",
12		"age":  18,
13		"ok":   true,
14	}
15	data, _ := json.Marshal(m)
16	fmt.Println(string(data))
17
18	// JSON → map
19	var m2 map[string]any
20	_ = json.Unmarshal(data, &m2)
21	fmt.Println(m2["name"], m2["age"])
22	// 注意:JSON 数字默认解成 float64
23
24	// 切片
25	list := []string{"芋泥波波", "绿茶", "红茶"}
26	b, _ := json.Marshal(list)
27	fmt.Println(string(b)) // ["芋泥波波","绿茶","红茶"]
28}
29

map[string]any 很灵活,但类型要自己断言。业务数据优先用结构体,类型更安全。

数字反序列化进 any 时是 float64,不是 int:

1var m map[string]any
2_ = json.Unmarshal([]byte(`{"age":18}`), &m)
3age := m["age"].(float64) // 对
4// age := m["age"].(int)  // panic:类型不对
5

Encoder / Decoder(流式)

跟文件、网络连接打交道时,不必先读成整段 []byte,可以用流式接口:

1package main
2
3import (
4	"encoding/json"
5	"fmt"
6	"os"
7	"strings"
8)
9
10type Person struct {
11	Name string `json:"name"`
12	Age  int    `json:"age"`
13}
14
15func main() {
16	// Encoder:往 Writer 写 JSON
17	enc := json.NewEncoder(os.Stdout)
18	_ = enc.Encode(Person{Name: "小满", Age: 18})
19	// 输出一行 JSON,末尾自带换行
20
21	// Decoder:从 Reader 读 JSON
22	r := strings.NewReader(`{"name":"奶茶","age":20}`)
23	dec := json.NewDecoder(r)
24
25	var p Person
26	_ = dec.Decode(&p)
27	fmt.Printf("%+v\n", p)
28}
29
API场景
Marshal / Unmarshal内存里一整段 JSON
NewEncoder / NewDecoder文件、HTTP Body、长连接等流

常见坑

1. 字段未导出

1type Bad struct {
2	name string // 小写:Marshal 后是 {}
3}
4

必须写成 Name,再用 tag 映射成 name。

2. 时间字段

time.Time 默认按 RFC3339 字符串编解码:

1type Event struct {
2	Name string    `json:"name"`
3	At   time.Time `json:"at"`
4}
5

JSON 侧一般是 "2026-10-15T23:52:00+08:00" 这种格式。

3. 指针字段与 omitempty

想用「没传」和「传了零值」区分时,常用指针:

1type Patch struct {
2	Age *int `json:"age,omitempty"`
3}
4// Age == nil → 没传;Age 指向 0 → 明确传了 0
5

4. 严格校验多余字段

默认会忽略 JSON 里多出来的键。若要拒绝未知字段:

1dec := json.NewDecoder(r)
2dec.DisallowUnknownFields()
3err := dec.Decode(&p)
4

速查表

你想做的事优先用
值 → JSON 字节json.Marshal
美化输出json.MarshalIndent
JSON 字节 → 值json.Unmarshal(data, &v)
改 JSON 字段名`json:"xxx"`
空值不输出`json:"xxx,omitempty"`
永久隐藏字段`json:"-"`
写到文件/响应流json.NewEncoder(w).Encode(v)
从请求体读json.NewDecoder(r).Decode(&v)

入门阶段先把 Marshal / Unmarshal + 结构体 tag 练熟;需要读写 HTTP Body 或文件时再上 Encoder / Decoder。

作业

  1. 定义 User(name、age、email),Marshal 成 JSON 并打印。
  2. 把一段 JSON 字符串 Unmarshal 进同一个结构体,打印各字段。
  3. 给 email 加 omitempty,不赋值时确认输出里没有该字段。
  4. 用 json:"-" 隐藏一个 Password 字段,确认序列化结果不含密码。
  5. 写嵌套结构体 Product + Price,完成一次往返编解码。

参考文档


《Go语言第十五章(JSON序列化)》 是转载文章,点击查看原文。


相关推荐


Web 渗透提权路径思维(七):云环境 IAM 角色越权与元数据服务自查
硅徒2026/10/21

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */ #content_views .toc, /* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */ #content_views.markdown_views > p:empty:has(+ .toc), #content_views.markdown_views > .toc + p:emp


LangChain定义聊天模型 基础问答
bit::Shadow(⊙o⊙)2026/10/17

@bit::Shadow ✧(≖ ◡ ≖✿  目录 定义聊天模型 Page2 Page3 本地部署 LLM 演示(32) 本文介绍LangChain中聊天模型的定义与使用,通过ChatOpenAI和ChatOllama实现本地及云端大模型调用。利用LCEL(LangChain Expression Language)的管道符|组合模型与解析器,实现消息流式处理与结果解析。支持配置化参数(如model、max_tokens),并通过configurab


给 Django Admin 加审批流:一行前端代码没写,298 行接上工作流引擎
mldong2026/10/12

一、Django 自带的那套后台,本来就长得像审批页 一个后台系统里的审批界面,剥到底就是三样东西:一张待办列表、两个按钮(同意/驳回)、一个发起表单。 而 Django 的 admin 干的就是这件事——你给它一个 Model,它自动配好列表页、详情页、字段过滤、搜索框、分页、权限校验,还有一套"勾选若干行 → 执行一个动作"的批量操作机制。 于是有一个很自然的想法:如果审批流的状态本来就躺在数据库表里,那 admin 是不是直接就能批单子? 答案是可以。这次做的东西一共 298 行 Pyth


使用 SciPy 库进行时间序列分析
databook2026/10/3

时间序列分析听起来有点学术,但其实干起来挺直接的。 你有一串按时间排列的数据,想知道里面有没有趋势、有没有周期性、噪声有多大,或者两个序列之间有没有延迟关系。 SciPy 这个库在信号处理、统计检验方面提供了不少现成的工具,配合 Matplotlib 画图,基本能覆盖日常分析的大部分需求。 本文不是单纯的介绍知识点,而是直接造一组模拟的全年每日温度数据,然后一步步用它演示: 怎么平滑 怎么滤波 怎么去趋势 怎么找周期 怎么看自相关和互相关 每一步都配上代码和图表,你跟着跑一遍,自然就知道 S


一套“嵌入式硬件 + 物联网”可视化,如何计算Highcharts许可证数量?
Highcharts.js2026/9/27

企业软件采购与授权合规实务,如何计算 Highcharts 许可证? 在智能水表、智慧水务、物联网、能源管理等项目中,Highcharts 经常同时出现在两个不同层面: 嵌入式智能水表、网关或终端设备物联网运营中台、Web 管理平台或 SaaS 系统 这两个场景虽然都使用 Highcharts 进行数据可视化,但在商业交付模式上可能完全不同,因此不能简单按照“水表有多少块,就购买多少套 Highcharts”来计算许可证。 真正需要判断的是: Highcharts 最终在哪里运行?谁可以使用?


把 KES 集群交给 Kubernetes 的九十天:一个 DBA 的试用实录
我是杰尼2026/9/19

把 KES 集群交给 Kubernetes 的九十天:一个 DBA 的试用实录 第 0 天:一个押上睡眠质量的决定 先交代背景。我在团队里负责十多套金仓 KES(KingbaseES)数据库集群的运维,主备流复制架构,跑在虚拟机上。这套体系我们维持了几年,谈不上优雅,但胜在熟悉——每台机器的脾气、每个实例的参数、每份应急预案的位置,都在心里有一本账。 变化来自两个方向。一是公司基础架构全面转向 Kubernetes,业务应用一批批迁入,平台组开始追问"数据库什么时候跟上";二是我们自己的痛感在


推理链中的 Token 冗余与剪枝:消除无意义语气词对注意力权重的稀释
醍醐实验室2026/9/11

推理链中的 Token 冗余与剪枝:消除无意义语气词对注意力权重的稀释 随着大模型深度推理(Reasoning Models)能力的演进,生成超长思维链(Long-CoT)已经成为解决复杂数学、符号规划与长代码生成的标准范式。 然而,在审视模型输出的长达数千 Token 的推导轨迹时,我们经常会看到大量高度冗余的过渡性表达,例如:“Let me pause and think...”、“Wait, is this correct? Let's check again...”、“Hmm, let


react-bits:从 36K stars 的“酷炫组件”,看动效如何成为 React 的可复用能力
吴琼琼2026/9/3

react-bits:从 36K stars 的“酷炫组件”,看动效如何成为 React 的可复用能力 打开一个视觉表现力强的网页,人们最先注意到的往往不是组件边界、状态管理或样式组织,而是“这个效果很酷”。文字浮现、背景变化、鼠标交互、内容切换,这些细节能让同样的信息架构呈现出完全不同的气质。 但前端开发里,“很酷”从来不是终点。 一个效果如果只能存在于单个页面的临时代码里,它带来的价值通常很短;如果它能够被抽象为可理解、可选择、可组合的组件,才有机会从一次视觉尝试变成稳定的开发能力。 rea


一条命令,十分钟:jeeflow 工作流应用的六语言一键部署
mldong2026/8/26

系列定位:jeeflow 系列第 9 篇(第三季「多语言联邦」第 1 篇) 平台:公众号 / 掘金(实用向:一键部署 + 选型) 素材版本:引擎 Java 1.8.18 / Go·Python·Node 1.8.20 / PHP 1.3.5 / Rust 1.0.5;一键部署脚本取自 mldong-website 前置阅读:第 8 篇 · 会签三兄弟:并行/串行/按比例的实现与取舍 一、先上结果 在任意一台装了 Docker 的 Linux 服务器上,执行一条命令: curl -fsSL h


Fiber 与 PHP 8.6 Polling API 异步初探
BingoGo2026/8/13

Fiber 与 PHP 8.6 Polling API 异步初探 几周前的一篇文章曾介绍 Polling API RFC,并将其定位为被低估的提案,原因主要在于:报道往往漏掉了真正的动机——那是内部 php_poll.h API,而非用户态的 Io\Poll 类。这一判断至今仍然成立。不过随后收到了不少类似"好吧,可它到底能用来做什么?"的反馈。这是个合理的问题,也正是本文要回答的问题。 时机也恰到好处。该 RFC 以 33 票赞成、1 票反对、4 票弃权通过,并于 6 月 3 日投票截止,实

首页编辑器站点地图

本站内容在 CC BY-SA 4.0 协议下发布

Copyright © 2026 聚合阅读