首先定义Person结构体并创建测试用JSON文件，接着实现ReadJSON和WriteJSON函数用于文件读写，然后编写单元测试验证数据读取与写入的正确性，最后通过使用testdata目录和临时文件确保测试环境隔离，保障JSON操作的可靠性。
在Go语言开发中，JSON文件的读写操作非常常见，尤其是在处理配置文件、API数据交换或持久化存储时。为了确保程序对JSON文件的操作正确可靠，编写针对性的单元测试尤为重要。下面介绍如何在Golang中对JSON文件的读写进行有效测试。
1. 准备测试用的结构体和JSON文件
首先定义一个简单的结构体，用于表示要序列化和反序列化的数据：
type Person struct {
Name string `json:"name"`
Age int `json:"age"`
Email string `json:"email,omitempty"`
}
然后创建一个测试用的JSON文件 testdata/person.json：
{
"name": "Alice",
"age": 25,
"email": "alice@example.com"
}
2. 实现JSON读写函数
编写两个函数：一个用于从文件读取JSON，另一个用于写入JSON到文件：
立即学习“go语言免费学习笔记（深入）”；
func ReadJSON(filename string, v interface{}) error {
data, err := os.ReadFile(filename)
if err != nil {
return err
}
return json.Unmarshal(data, v)
}
func WriteJSON(filename string, v interface{}) error {
data, err := json.MarshalIndent(v, "", " ")
if err != nil {
return err
}
return os.WriteFile(filename, data, 0644)
}
3. 编写单元测试验证读写逻辑
使用 testing 包编写测试函数，验证读写是否正确：
func TestReadJSON(t *testing.T) {
var p Person
err := ReadJSON("testdata/person.json", &p)
if err != nil {
t.Fatalf("读取JSON失败: %v", err)
}
if p.Name != "Alice" {
t.Errorf("期望名字为Alice，实际为 %s", p.Name)
}
if p.Age != 25 {
t.Errorf("期望年龄为25，实际为 %d", p.Age)
}
if p.Email != "alice@example.com" {
t.Errorf("期望邮箱为alice@example.com，实际为 %s", p.Email)
}
}
func TestWriteJSON(t *testing.T) {
tempFile := "testdata/output.json"
person := Person{
Name: "Bob",
Age: 30,
Email: "bob@example.com",
}
err := WriteJSON(tempFile, person)
if err != nil {
t.Fatalf("写入JSON失败: %v", err)
}
defer os.Remove(tempFile) // 清理临时文件
// 验证写入后能否正确读回
var p Person
err = ReadJSON(tempFile, &p)
if err != nil {
t.Fatalf("读取写入的文件失败: %v", err)
}
if p.Name != "Bob" || p.Age != 30 || p.Email != "bob@example.com" {
t.Errorf("读回的数据不匹配: %+v", p)
}
}
4. 使用测试目录和临时文件的最佳实践
Go推荐将测试数据放在 testdata 目录中，该目录不会被包导入，专为测试准备。同时，在写入测试中使用临时文件或 os.CreateTemp 可避免污染项目文件。
例如：
tempFile, err := os.CreateTemp("testdata", "temp_*.json")
if err != nil {
t.Fatal(err)
}
defer os.Remove(tempFile.Name())
这样可以确保每次测试都在干净的环境中运行。
基本上就这些。通过结构化设计、合理使用 testdata 目录和完整的读写验证，可以高效保障Golang中JSON文件操作的稳定性与正确性。
