Go中测试JSON序列化与反序列化需确保双向转换保值、保类型、保字段语义，重点验证标签控制、零值处理、嵌套结构、自定义方法及边界场景。
在 Go 中测试 JSON 序列化（json.Marshal）和反序列化（json.Unmarshal），核心是验证结构体与 JSON 字符串之间的双向转换是否保值、保类型、保字段语义。重点不是“能不能跑通”，而是“数据有没有被意外修改或丢失”。
用结构体标签明确控制 JSON 字段名和行为
Go 的 JSON 编解码依赖结构体字段的标签（如 json:"name"）。测试前先确保标签定义合理：
- 导出字段（首字母大写）才参与序列化；未导出字段默认忽略
- 使用
json:"name,omitempty"控制零值字段是否输出，测试时需覆盖零值场景（如空字符串、0、nil 切片） - 用
json:"-"显式排除敏感或非 JSON 字段，避免误序列化 - 嵌套结构体、指针、时间（
time.Time）、自定义类型（如枚举）要单独验证其 JSON 行为
编写双向一致性测试（Marshal → Unmarshal → Equal）
最有效的测试模式是：构造原始结构体 → Marshal 成 JSON → Unmarshal 回新结构体 → 比较原始与还原后的值是否一致。推荐用 cmp.Equal（来自 github.com/google/go-cmp/cmp）代替 reflect.DeepEqual，它能清晰报告差异位置。
示例：
立即学习“go语言免费学习笔记（深入）”；
从 Git 仓库历史中彻底删除文件
下载
|Git删除了文件，但还会在Git 仓库历史中遗留。 - 想要从 Git 历史移除敏感信息（密码、密钥、token、私钥） - 想要删除意外提交的大文件 - 想要重写 Git 历史、移除特定文件的所有痕迹 - 提到 "force push"、"重写 commit 历史" - 需要从所有分支、所有 tag 中删除某个文件
func TestUserJSONRoundTrip(t *testing.T) {
original := User{
ID: 123,
Name: "Alice",
Tags: []string{"dev", "golang"},
CreatedAt: time.Date(2024, 1, 15, 10, 30, 0, 0, time.UTC),
}
data, err := json.Marshal(original)
if err != nil {
t.Fatal(err)
}
var restored User
if err := json.Unmarshal(data, &restored); err != nil {
t.Fatal(err)
}
if !cmp.Equal(original, restored, cmp.Comparer(func(x, y time.Time) bool {
return x.Equal(y)
})) {
t.Errorf("round-trip failed: %s", cmp.Diff(original, restored))
}
}
覆盖边界和易错场景
仅测“正常值”容易漏掉隐性 bug。以下情况必须单独测试：
-
零值字段：比如
Age int `json:"age,omitempty"`，当Age == 0时是否真的被省略？检查生成的 JSON 是否不含"age": 0 -
空切片 vs nil 切片：两者 JSON 都是
[]，但 Go 语义不同；若业务逻辑区分二者，需在 Unmarshal 后手动校验len(s) == 0 && s == nil -
嵌套结构体中的指针字段：nil 指针序列化为
null，反序列化后仍是 nil；非 nil 指针需确认深层字段也被正确还原 - 非法 JSON 输入：传入格式错误或字段类型错配的 JSON（如用字符串给数字字段赋值），验证是否返回预期错误，而非静默失败或 panic
对自定义 JSON 行为做单元测试（实现 MarshalJSON/UnmarshalJSON）
当结构体需要特殊序列化逻辑（如把时间转为秒级时间戳、枚举转字符串名），必须为该方法单独写测试：
- 测试
MarshalJSON()输出是否符合协议约定（如字段名、类型、格式） - 测试
UnmarshalJSON([]byte)能否正确解析各种合法输入，且对非法输入返回有意义错误 - 仍要做 round-trip 测试，确保自定义逻辑不破坏一致性
例如，一个将 time.Time 序列化为 Unix 秒的字段：
func (t *Timestamp) MarshalJSON() ([]byte, error) {
return json.Marshal(t.Time.Unix())
}
func (t *Timestamp) UnmarshalJSON(data []byte) error {
var sec int64
if err := json.Unmarshal(data, &sec); err != nil {
return err
}
t.Time = time.Unix(sec, 0)
return nil
}
对应测试需验证 time.Now().Unix() 和反序列化后的时间是否一致（考虑秒级精度误差）。
