golang中json操作的完全指南

前言

JSON是一种轻量级的数据交换格式。易于阅读和编写。 golang 提供了 encoding/json 包来操作JSON数据。

1. 结构体与JSON互转

（1）使用 json.Marshal() 方法，把结构体转成 JSON字符串

import (

	"encoding/json"

	"fmt"

)



type Student struct {

	Name string

	Age int

	Skill string

}



func main()  {

	stu := Student{"tom", 12, "football"}

	data, err := json.Marshal(&stu)

	if err != nil {

		fmt.Printf("序列化错误 err=%v\n", err)

		return

	}

	fmt.Println("序列化后: ", string(data))

}

打印： 序列化后: {“Name”:“tom”,“Age”:12,“Skill”:“football”}

（2）JSON字符串 转 结构体，可以使用 json.Unmarshal()方法

func main()  {

	str := `{"Name":"tom","Age":12,"Skill":"football"}`

	var stu2 Student

	err := json.Unmarshal([]byte(str), &stu2)

	if err != nil {

		fmt.Printf("反序列化错误 err=%v\n", err)

		return

	}

	fmt.Printf("反序列化后: Student=%v, Name=%v\n", stu2, stu2.Name)

}

打印: 反序列化后: Student={tom 12 football}, Name=tom

（3）如何实现结构体序列化后key的名称能自定义

对于自定义key的名称，可以给 struct变量指定一个tag标签

type Student struct {

	Name string   `json:"stu_name"`

	Age int       `json:"stu_age"`

	Skill string  // 也可以不指定 tag标签，默认就是 变量名称

}



func main()  {

	stu := Student{"tom", 12, "football"}

	data, err := json.Marshal(&stu)

	if err != nil {

		fmt.Printf("序列化错误 err=%v\n", err)

		return

	}

	fmt.Println("序列化后: ", string(data))

}

打印后，可以看到 key的名称已经变成了我们指定的 tag标签 的名称

序列化后: {“stu_name”:“tom”,“stu_age”:12,“Skill”:“football”}

2. map与JSON互转

func main()  {

	// map 转 Json字符串

	m := make(map[string]interface{})

	m["name"] = "jetty"

	m["age"] = 16



	data, err := json.Marshal(&m)

	if err != nil {

		fmt.Printf("序列化错误 err=%v\n", err)

		return

	}

	fmt.Println("序列化后: ", string(data))    // 打印: 序列化后:  {"age":16,"name":"jetty"}



	// Json字符串 转 map

	str := `{"age":25,"name":"car"}`

	err = json.Unmarshal([]byte(str), &m)

	if err != nil {

		fmt.Printf("反序列化错误 err=%v\n", err)

		return

	}

	fmt.Printf("反序列化后: map=%v, name=%v\n", m, m["name"])

	// 打印: 反序列化后: map=map[age:25 name:car], name=car

}

3. 结构体的变量不加tag标签能否正常转成json数据

如果变量首字母小写，则为private。因为取不到反射信息，不能转。

如果变量首字母大写，则为public。不管加不加 tag 都能正常转，加了tag的变量就按照tag的名称显示。

示例：

type User struct {

	Name string    `json:"u_name"`

	age int        `json:"u_age"`

	Skill string   // 也可以不指定 tag标签，默认就是 变量名称

	addr string

}



func main()  {

	user := User{"admin", 23, "football", "上海"}

	data, err := json.Marshal(&user)

	if err != nil {

		fmt.Printf("序列化错误 err=%v\n", err)

		return

	}

	fmt.Println("序列化后: ", string(data))  // 打印: 序列化后:  {"u_name":"admin","Skill":"football"}

}

通过打印，我们发现小写的变量，如 age、addr 都没有转成 json数据。

总结：

首字母小写的不管加不加tag都不能转为json数据，而大写的加了tag可以取别名，不加tag则json内的字段跟结构体变量原名一致

4. JSON操作的一些小技巧

（1）忽略掉 struct 指定字段

type User struct {

	Name string    `json:"u_name"`

	Password string `json:"password"`

	Email string `json:"email"`

}



func main()  {

	user := User{"admin", "pwd", "user@163.com"}

	person := Person{23, "上海"}

	// 忽略掉 Password 字段

	data, _ := json.Marshal(struct {

		*User

		Password string `json:"password,omitempty"`

	}{User: &user})

	fmt.Println("忽略字段: ", string(data))  // 打印: 忽略字段: {"u_name":"admin","email":"user@163.com"}

}

忽略字段: {“u_name”:“admin”,“email”:“user@163.com”}}

（2）添加额外的字段

data, _ = json.Marshal(struct {

	*User

	Skill string `json:"skill"`  // 临时添加额外的 Skill字段

}{

	User: &user,

	Skill: "football",

})



fmt.Println("添加额外字段: ", string(data))

添加额外字段: {“u_name”:“admin”,“password”:“pwd”,“email”:“user@163.com”,“skill”:“football”}

（3）合并两个 struct

type User struct {

	Name string    `json:"u_name"`

	Password string `json:"password"`

	Email string `json:"email"`

}



type Person struct {

	Age int

	Addr string `json:"addr"`

}



func main()  {

    // 初始化两个 struct

	user := User{"admin", "pwd", "user@163.com"}

	person := Person{23, "上海"}

	

	data, _ := json.Marshal(struct {

		*User

		*Person

	}{

		User: &user,

		Person: &person,

	})

	

	fmt.Println("合并两个struct: ", string(data))

}

合并两个struct: {“u_name”:“admin”,“password”:“pwd”,“email”:“user@163.com”,“Age”:23,“addr”:“上海”}

（4）字符串传递给 int类型

emp := struct {                    // 创建匿名 struct

	Num int `json:"num,string"`

}{15,}

data, _ := json.Marshal(&emp)

fmt.Println("数字转成字符串: ", string(data))       // 数字转成字符串: {"num":"15"}



str := `{"Num":"25"}`

_ = json.Unmarshal([]byte(str), &emp)

fmt.Printf("字符串转成数字: Emp.Num=%v\n", emp.Num) // 字符串转成数字: Emp.Num=25

（5）一个 json 分成两个struct

str = ` {"u_name":"system","password":"abc","email":"user2@163.com","Age":23,"addr":"杭州"}`

var user2 User

var person2 Person

_ := json.Unmarshal([]byte(str), &struct {

	*User

	*Person

}{

	User: &user2,

	Person: &person2,

})



fmt.Printf("分成两个struct: User=%v, Person=%v\n", user2, person2)

分成两个struct: User={system abc user2@163.com}, Person={23 杭州}

补充：GoLang json格式化输出

简单记录一下go语言json格式化输出的办法

import (

    "bytes"

    "encoding/json"

    "fmt"

    "os"

)



type Complex_Type struct{

    Age int `json:"age"`

    Name string `json:"name"`

    Grades map[string]int `json:"grade"`

    Parents []string `json:"parents"`

}



    grades := map[string]int{

        "math" : 96,

        "chinese" : 87,

        "english" : 93,

    }



    parents := []string{

        "minato",

        "kushina",

    }



    complex_type := Complex_Type{

        Age: 18,

        Name: "Naruto",

        Grades : grades,

        Parents: parents,

    }

    res,err := json.Marshal(complex_type)

    exitOnError(err)

    var out bytes.Buffer

    err = json.Indent(&out,res,"","\t")

    out.WriteTo(os.Stdout)

    fmt.Printf("\n")

输出：

总结