答案：文章介绍了在Go项目中如何使用testing包和encoding/json对结构体进行JSON序列化与反序列化测试。首先定义带有json tag的User结构体，然后编写TestUser_MarshalJSON测试正常序列化、TestUser_MarshalJSON_OmitEmpty验证omitempty行为、TestUser_UnmarshalJSON测试反序列化正确性，并可通过testify库简化字段比较，确保API数据交互的可靠性。
测试 JSON 序列化在 Go 项目中很常见，尤其是在构建 API 或处理数据传输时。你需要确保结构体能正确地编码为 JSON 字符串，也能从 JSON 正确解码回来。下面介绍如何用 Golang 的 testing 包和 encoding/json 来完成这类测试。
定义待序列化的结构体
假设你有一个表示用户信息的结构体：
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Email string `json:"email,omitempty"`
}
字段上的 json tag 控制了序列化后的键名，omitempty 表示当字段为空时不会出现在 JSON 输出中。
编写测试函数验证序列化
在 user_test.go 中写一个测试，检查结构体能否正确转成预期的 JSON。
立即学习“go语言免费学习笔记（深入）”；
func TestUser_MarshalJSON(t *testing.T) {
user := User{
ID: 1,
Name: "Alice",
Email: "alice@example.com",
}
data, err := json.Marshal(user)
if err != nil {
t.Fatalf("marshal failed: %v", err)
}
expected := `{"id":1,"name":"Alice","email":"alice@example.com"}`
if string(data) != expected {
t.Errorf("expected %s, got %s", expected, string(data))
}
}
这个测试验证了：
- json.Marshal 能成功执行
- 输出的 JSON 字符串与预期一致
测试空字段的 omitempty 行为
你可以再写一个测试，验证当 Email 为空时，它是否被省略。
func TestUser_MarshalJSON_OmitEmpty(t *testing.T) {
user := User{
ID: 2,
Name: "Bob",
// Email 留空
}
data, err := json.Marshal(user)
if err != nil {
t.Fatalf("marshal failed: %v", err)
}
expected := `{"id":2,"name":"Bob"}`
if string(data) != expected {
t.Errorf("expected %s, got %s", expected, string(data))
}
}
测试反序列化（Unmarshal）
除了序列化，你也应测试从 JSON 还原结构体是否正确。
func TestUser_UnmarshalJSON(t *testing.T) {
input := `{"id":3,"name":"Charlie","email":"charlie@example.com"}`
var user User
err := json.Unmarshal([]byte(input), &user)
if err != nil {
t.Fatalf("unmarshal failed: %v", err)
}
if user.ID != 3 {
t.Errorf("expected ID 3, got %d", user.ID)
}
if user.Name != "Charlie" {
t.Errorf("expected Name Charlie, got %s", user.Name)
}
if user.Email != "charlie@example.com" {
t.Errorf("expected Email charlie..., got %s", user.Email)
}
}
这种测试确保你的结构体能正确解析外部输入的 JSON 数据。
使用反射或 testify 提高测试可读性
如果字段较多，手动比较每个字段会很繁琐。可以使用 reflect.DeepEqual 或第三方库如 testify/assert 简化断言。
import "github.com/stretchr/testify/assert"
func TestUser_UnmarshalJSON_WithTestify(t *testing.T) {
input := `{"id":4,"name":"Dana"}`
var user User
json.Unmarshal([]byte(input), &user)
expected := User{ID: 4, Name: "Dana"}
assert.Equal(t, expected, user)
}
这样代码更简洁，也更容易维护。
基本上就这些。只要覆盖典型场景：正常序列化、空字段处理、反序列化还原，就能保证你的结构体在 JSON 交互中表现可靠。
