Go 语言 JSON 序列化与反序列化：如何规避文件操作中的常见陷阱

package main

import (
    "encoding/json"
    "io/ioutil" // 在 Go 1.16+ 中，其功能已迁移至 os 和 io 包
    "log"
)

// SomeType 定义了需要序列化/反序列化的数据结构
type SomeType struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
    City string `json:"city"`
}

// Save 函数将 Go 对象序列化为 JSON 并保存到文件
func Save(myObj SomeType, filename string) error {
    // 1. 将 Go 对象序列化为 JSON 字节切片
    data, err := json.Marshal(myObj)
    if err != nil {
        log.Printf("Error marshaling object: %v", err)
        return err
    }

    // 2. 将 JSON 字节切片写入文件
    // ioutil.WriteFile 会创建文件（如果不存在），并覆盖现有内容。
    // 0644 是文件权限：所有者读写，组用户和其他用户只读。
    err = ioutil.WriteFile(filename, data, 0644)
    if err != nil {
        log.Printf("Error writing file %s: %v", filename, err)
        return err
    }
    log.Printf("Data successfully saved to %s", filename)
    return nil
}

// Load 函数从文件读取 JSON 数据并反序列化为 Go 对象
func Load(filename string) (SomeType, error) {
    var myObj SomeType

    // 1. 从文件读取所有内容到字节切片
    data, err := ioutil.ReadFile(filename)
    if err != nil {
        log.Printf("Error reading file %s: %v", filename)
        return myObj, err
    }

    // 2. 将 JSON 字节切片反序列化为 Go 对象
    err = json.Unmarshal(data, &myObj)
    if err != nil {
        log.Printf("Error unmarshaling data from %s: %v", filename, err)
        return myObj, err
    }
    log.Printf("Data successfully loaded from %s: %+v", filename, myObj)
    return myObj, nil
}

func main() {
    // 示例使用
    objToSave := SomeType{Name: "Alice", Age: 30, City: "New York"}
    filename := "data.json"

    // 保存数据
    if err := Save(objToSave, filename); err != nil {
        log.Fatalf("Failed to save data: %v", err)
    }

    // 加载数据
    loadedObj, err := Load(filename)
    if err != nil {
        log.Fatalf("Failed to load data: %v", err)
    }
    log.Printf("Loaded object: %+v", loadedObj)

    // --- 模拟错误情况（请勿在生产环境中使用此部分） ---
    // 以下代码旨在演示当文件内容被破坏时，Load 函数会如何报错。
    // 将一个非法的字符 '1' 放在一个合法 JSON 对象的后面
    corruptedData := []byte(`{"name":"Bob","age":25,"city":"London"}123`)
    if err := ioutil.WriteFile(filename, corruptedData, 0644); err != nil {
        log.Fatalf("Failed to corrupt file: %v", err)
    }
    log.Println("Attempting to load corrupted file...")
    _, err := Load(filename)
    if err != nil {
        log.Printf("Successfully caught expected error: %v", err) // 会打印 "invalid character '1' after top-level value"
    }
    // --- 模拟错误情况结束 ---
}