goalng如何struct转json

Go语言中Struct转JSON的完整指南

在Go语言开发中，将结构体（struct）转换为JSON格式是一项常见任务，无论是构建API响应、配置文件处理还是数据交换，都需要struct到JSON的转换技巧,本文将详细介绍Go语言中struct转JSON的各种方法和注意事项。

JSON.Marshal：基础转换方法

Go语言标准库中的encoding/json包提供了Marshal函数,这是将struct转换为JSON的主要方法。

package main
import (
    "encoding/json"
    "fmt"
)
type User struct {
    Name  string `json:"name"`
    Age   int    `json:"age"`
    Email string `json:"email"`
}
func main() {
    user := User{
        Name:  "张三",
        Age:   30,
        Email: "zhangsan@example.com",
    }
    jsonData, err := json.Marshal(user)
    if err != nil {
        fmt.Println("转换失败:", err)
        return
    }
    fmt.Println(string(jsonData))
    // 输出: {"name":"张三","age":30,"email":"zhangsan@example.com"}
}

结构体标签（Tags）的重要性

在Go中，结构体标签（tags）控制JSON转换的行为,常用的标签选项包括：

json:"field_name"：指定JSON字段名
json:"-"：忽略该字段
json:"omitempty"：当字段为零值时省略
json:"string"：将数字/布尔值转为JSON字符串

type Product struct {
    Name     string  `json:"name"`
    Price    float64 `json:"price,string"`  // 转为字符串
    InStock  bool    `json:"in_stock,omitempty"` // 零值时省略
    Category string  `json:"-"`             // 忽略此字段
}

处理复杂嵌套结构

JSON可以表示复杂嵌套结构,Go的struct也能很好地对应：

type Address struct {
    City    string `json:"city"`
    Street  string `json:"street"`
    ZipCode string `json:"zip_code"`
}
type Person struct {
    Name    string  `json:"name"`
    Age     int     `json:"age"`
    Address Address `json:"address"`
    Hobbies []string `json:"hobbies"`
}
func main() {
    person := Person{
        Name: "李四",
        Age:  25,
        Address: Address{
            City:    "北京",
            Street:  "长安街1号",
            ZipCode: "100001",
        },
        Hobbies: []string{"读书", "游泳"},
    }
    jsonData, _ := json.Marshal(person)
    fmt.Println(string(jsonData))
}

处理指针类型

当struct字段为指针类型时，Marshal会自动处理nil值：

type Employee struct {
    Name   *string `json:"name"`
    Age    *int    `json:"age,omitempty"`
    Active *bool   `json:"active"`
}
func main() {
    name := "王五"
    age := 35
    active := true
    employee := Employee{
        Name:   &name,
        Age:    &age,
        Active: &active,
    }
    jsonData, _ := json.Marshal(employee)
    fmt.Println(string(jsonData)) // {"name":"王五","age":35,"active":true}
}

自定义JSON转换逻辑

对于特殊转换需求，可以实现json.Marshaler接口：

type CustomTime struct {
    time.Time
}
func (ct CustomTime) MarshalJSON() ([]byte, error) {
    return []byte(fmt.Sprintf(`"%s"`, ct.Format("2006-01-02"))), nil
}
type Event struct {    string     `json:"title"`
    Timestamp CustomTime `json:"timestamp"`
}