Go语言中JSON反序列化-转成结构体-在Go语言中可以使用包将JSON数据解析为结构体

作者：IDC报告小组 | 发布时间：2025-06-12 |

一、Go语言中JSON与结构体的序列化和反序列化

在Go语言里，序列化（把结构体转成JSON）和反序列化（把JSON转成结构体）都是用标准库来实现的。接下来，我会一步步地教你怎么做。

序列化

我们可以用json.Marshal这个方法，把结构体转换成JSON格式的字符串。下面是一个简单的例子：

```go package main import ( "encoding/json" "fmt" ) type Person struct { Name string Age int Address string } func main() { p := Person{ Name: "Alice", Age: 30, Address: "123 Wonderland Lane", } jsonData, err := json.Marshal(p) if err != nil { fmt.Println("Error marshaling JSON:", err) return } fmt.Println(string(jsonData)) } ```

反序列化

相反，我们也可以用json.Unmarshal把JSON字符串转换回结构体。看下面这个例子：

```go package main import ( "encoding/json" "fmt" ) type Person struct { Name string Age int Address string } func main() { jsonData := `{"Name":"Bob","Age":25,"Address":"456 Fantasy Road"}` var p Person err := json.Unmarshal([]byte(jsonData), &p) if err != nil { fmt.Println("Error unmarshaling JSON:", err) return } fmt.Println(p) } ```

二、结构体标签的使用

在Go语言中，结构体标签（通常写作反引号`和字符串）可以用来控制JSON字段的名称，甚至可以用来忽略某些字段。这些都是通过反射机制来实现的。下面是一些常见的标签选项：

标签 作用
`json:"name"` 指定JSON字段的名称
`json:"-" 忽略该字段
`json:"omitempty"` 当字段为空时忽略

修改字段名称的例子：

```go type Person struct { Name string `json:"name"` Age int `json:"age"` Address string `json:"address"` } ```

忽略字段的例子：

```go type Person struct { Name string `json:"name"` Age int `json:"age"` Address string `json:"-"` // 这个字段会被忽略 } ```

三、使用自定义类型进行序列化和反序列化

有时候，你可能需要对某些字段进行特殊处理。这时，你可以实现一个接口，并使用自定义类型。下面是一个例子：

```go package main import ( "encoding/json" "fmt" ) type CustomType struct { Field string } func (ct CustomType) MarshalJSON() ([]byte, error) { return json.Marshal(&struct { CustomType Type string `json:"type"` }{ CustomType: ct, Type: "Custom", }) } func (ct CustomType) UnmarshalJSON(data []byte) error { var obj struct { CustomType Type string `json:"type"` } if err := json.Unmarshal(data, &obj); err != nil { return err } if obj.Type != "Custom" { return fmt.Errorf("invalid type: %s", obj.Type) } ct = obj.CustomType return nil } func main() { ct := CustomType{Field: "example"} jsonData, err := json.Marshal(ct) if err != nil { fmt.Println("Error marshaling JSON:", err) return } fmt.Println(string(jsonData)) var newCT CustomType err = json.Unmarshal(jsonData, &newCT) if err != nil { fmt.Println("Error unmarshaling JSON:", err) return } fmt.Println(newCT) } ```

四、处理嵌套结构体

在实际开发中，嵌套结构体的情况很常见。Go语言的包同样支持嵌套结构体的序列化和反序列化。下面是一个嵌套结构体的例子：

```go type Address struct { Street string City string } type Person struct { Name string Age int Address Address } func main() { p := Person{ Name: "Alice", Age: 30, Address: Address{ Street: "123 Wonderland Lane", City: "Wonderland", }, } jsonData, err := json.Marshal(p) if err != nil { fmt.Println("Error marshaling JSON:", err) return } fmt.Println(string(jsonData)) } ```

五、处理未知的JSON字段

有时候，JSON数据中可能包含一些未知的字段。Go语言提供了灵活的处理方式。下面是一个将未知字段存储到map[string]interface{}的例子：

```go package main import ( "encoding/json" "fmt" ) type Person struct { Name string Age int Address string Unknown map[string]interface{} } func main() { jsonData := `{"Name":"Bob","Age":25,"Address":"456 Fantasy Road","ExtraInfo":{"Website":"http://example.com"}}` var p Person err := json.Unmarshal([]byte(jsonData), &p) if err != nil { fmt.Println("Error unmarshaling JSON:", err) return } fmt.Println(p) } ```

六、处理JSON数组

在实际开发中，经常会遇到JSON数组的情况。Go语言的包同样支持JSON数组的序列化和反序列化。下面是一个JSON数组的例子：

```go package main import ( "encoding/json" "fmt" ) type Person struct { Name string } func main() { jsonData := `["Alice", "Bob", "Charlie"]` var names []Person err := json.Unmarshal([]byte(jsonData), &names) if err != nil { fmt.Println("Error unmarshaling JSON:", err) return } fmt.Println(names) } ```

在Go语言中，使用标准库将结构体与JSON进行转换非常方便。你可以使用json.Marshal和json.Unmarshal来序列化和反序列化结构体。通过结构体标签，你可以控制JSON字段的名称。处理自定义类型、嵌套结构体、未知字段以及JSON数组等复杂场景也是实际项目中常见的问题。掌握这些技巧，你将能够在处理JSON数据时更加游刃有余。

相关问答FAQs

1. Go语言结构体如何存储为JSON格式？

在Go语言中，可以使用内置的包将结构体转换为JSON格式。下面是一个示例：

```go package main import ( "encoding/json" "fmt" ) type Person struct { Name string Age int Address string } func main() { p := Person{ Name: "Alice", Age: 30, Address: "123 Wonderland Lane", } jsonData, err := json.Marshal(p) if err != nil { fmt.Println("Error marshaling JSON:", err) return } fmt.Println(string(jsonData)) } ```

2. 如何处理结构体中的嵌套字段并将其存储为JSON？

如果结构体中包含嵌套的字段，那么可以使用相同的方法将其转换为JSON格式。下面是一个示例：

```go package main import ( "encoding/json" "fmt" ) type Address struct { Street string City string } type Person struct { Name string Age int Address Address } func main() { p := Person{ Name: "Alice", Age: 30, Address: Address{ Street: "123 Wonderland Lane", City: "Wonderland", }, } jsonData, err := json.Marshal(p) if err != nil { fmt.Println("Error marshaling JSON:", err) return } fmt.Println(string(jsonData)) } ```

3. 如何将JSON数据存储为结构体？

在Go语言中，可以使用包将JSON数据解析为结构体。下面是一个示例：

```go package main import ( "encoding/json" "fmt" ) type Person struct { Name string Age int Address string } func main() { jsonData := `{"Name":"Bob","Age":25,"Address":"456 Fantasy Road"}` var p Person err := json.Unmarshal([]byte(jsonData), &p) if err != nil { fmt.Println("Error unmarshaling JSON:", err) return } fmt.Println(p) } ``` 希望这些示例能够帮助你理解Go语言中结构体与JSON之间的转换和存储。