Go 参考

运行 Go 示例,学习处理 JSON 可选字段、严格解码,以及让 map 对比结果顺序固定。

运行示例

安装 Go 1.21 或更新版本。每个程序单独保存为 main.go,再运行 go run main.go。示例不需要外部模块。

区分缺失字段与零值

对新建的结构体解码时,缺失字段会让指针保持 nil。显式传入 0 则得到一个指向 0 的非空指针。

go
package main

import (
    "encoding/json"
    "fmt"
)

type Config struct {
    Port *int `json:"port"`
}

func main() {
    for _, input := range []string{"{}", `{"port":0}`} {
        var config Config
        if err := json.Unmarshal([]byte(input), &config); err != nil {
            panic(err)
        }
        if config.Port == nil {
            fmt.Println("port missing or null")
        } else {
            fmt.Println("port:", *config.Port)
        }
    }
}

预期输出

port missing or null
port: 0

常见误区

在新建结构体中,字段缺失和显式传入 null 都会产生 nil。单靠指针无法区分二者。

官方文档

拒绝未知字段和多余的 JSON

将数据解码到结构体时,用 DisallowUnknownFields 拒绝未知字段。只允许一个 JSON 值时,第一次解码成功后,第二次必须返回 io.EOF。

go
package main

import (
    "encoding/json"
    "fmt"
    "io"
    "strings"
)

func accepted(input string) bool {
    decoder := json.NewDecoder(strings.NewReader(input))
    decoder.DisallowUnknownFields()

    var config struct { Port int `json:"port"` }
    if err := decoder.Decode(&config); err != nil {
        return false
    }

    var extra any
    return decoder.Decode(&extra) == io.EOF
}

func main() {
    fmt.Println(accepted(`{"port":80}`))
    fmt.Println(accepted(`{"port":80,"unknown":true}`))
    fmt.Println(accepted(`{"port":80} {"port":81}`))
}

预期输出

true
false
false

常见误区

DisallowUnknownFields 不会拒绝重复键。只允许一个 JSON 值时,还要检查后面有无多余数据。

官方文档

按固定顺序列出 map 中变更的值

用带 ok 的查找,只比较两份 map 共有的键。Go 的 map 遍历顺序不固定,生成报告前要排序。

go
package main

import (
    "fmt"
    "slices"
)

func main() {
    before := map[string]int{"port": 80, "retries": 3, "timeout": 10}
    after := map[string]int{"port": 8080, "timeout": 0}
    var changed []string
    for key, old := range before {
        if current, ok := after[key]; ok && current != old {
            changed = append(changed, key)
        }
    }
    slices.Sort(changed)
    fmt.Println(changed)
}

预期输出

[port timeout]

常见误区

查找不存在的整数键会得到 0。在把结果当作显式的 0 之前,先检查键是否存在。

官方文档

相关工具