Golang 中空的切片转化成 JSON 后变为 null 的问题如何解决？

问题

在 Golang 中，经常需要将其他类型（例如 slice、map、struct 等类型）的数据转化为 JSON 格式。有时候转化的结果并不是预期中的，例如将一个空的切片转化为 JSON 时，会变成"null"，而并非预期的"[]"。示例代码如下：

package main

import (
    "encoding/json"
    "fmt"
)

func main() {
    var res []string

    b, err := json.Marshal(res)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(b))
}

运行示例看下结果：

$ go run main.go
null

结果输出的值为 “null”，而并非预期中的 “[]”。

原因

上面示例代码中的 res 是通过 var 关键字来声明为字符串类型切片的，这样的切片称为零值切片，其值为 nil，无指向任何内存地址。其出现实标题中这种情况的切片就是零值切片，接下来介绍下零值切片和空切片。

在 Golang 中，切片是一个长度可变的数组，有三个属性：指针、长度和容量。"零值切片"和"空切片"是两种特殊的切片。

1. 零值切片：当一个切片类型的变量被声明但没有被显式初始化时，它的值就是一个零值切片。零值切片不会被分配内存空间，长度和容量都是零，零值切片也可以说是 nil 切片。例如：

var s []string
fmt.Println(s == nil)  // 输出 "true"

1. 空切片：空切片的长度和容量也都是零，但是指向了一个真实的、虽然是空的，但已经分配了内存的数组。空切片可以通过 make 函数或者字面量语法来创建。例如：

s := make([]string, 0)
fmt.Println(s == nil)  // 输出 "false"

s := []string{}
fmt.Println(s == nil)  // 输出 "false"

在这两个例子中，s 都是空切片，长度和容量都是零，但是值不是 nil。

零值切片和空切片在大多数情况下是可以互换使用的，都可以用来表示一个空的集合。但是如果需要区分一个切片是否被显式初始化过，就需要注意它们的区别了。而 encoding/json 库对两者的处理方式就是不一样的，会将零值切片编码为“null”，而将空切片编码为 “[]”。这可能会在某些情况下引发问题，例如当接口对于数组的处理期望"[]"而非"null"时。

讲解到这里，相信大家已经知道本文题目的答案了，如果将空的切片转化为 JSON 格式后预期得到“[]”，就需要在声明切片时，使用 make 函数或者字面量语法来创建切片。看个简单的示例：

package main

import (
    "encoding/json"
    "fmt"
)

func main() {

    res := make([]string, 0)
    // 或者 res:= []string{}
    // 而非 var res []string

    b, err := json.Marshal(res)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(b))
}

运行代码看下效果：

$ go run main.go
[]

可以看出，达到了预期的效果。

小结

本文讲解了零值切片（nil 切片）和空切片的定义和差异，如果想将空的切片转化为 JSON 格式后得到 “[]”而不是“null”，最好的方式是使用 make 函数或者字面量语法来创建切片。