当前位置：首页 > 文章列表 > Golang > Go教程 > Go json.Decoder用 Token 识别嵌套边界的实现方式

Go json.Decoder用 Token 识别嵌套边界的实现方式

来源：17golang原创 2026-09-15 19:38:23 0浏览收藏

处理一段结构不固定、但又不想一次性反序列化成 map[string]any 的 JSON 时，Go json.Decoder 的 Token 很适合用来判断嵌套边界。它按流读取下一个 JSON token：普通字符串、数字、布尔值和 null 是值；{、}、[、] 会以 json.Delim 表示容器的进入和退出。

实现要点是“先分辨 token 类型，再维护容器深度”：遇到左分隔符进入一层，遇到右分隔符退出一层；当目标层级的右分隔符出现时，就能确定当前对象或数组已经结束。

Token 先分流：普通值、字段名和容器分隔符

Token 返回的是 (json.Token, error)。其中对象的键也会作为字符串 token 返回，所以不能把每个字符串都直接当成业务值。最小的判断方式是先做 json.Delim 类型断言，再处理其他值。

package main

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

func printTokens(input string) error {
    dec := json.NewDecoder(strings.NewReader(input))
    for {
        tok, err := dec.Token()
        if err != nil {
            // EOF 表示 token 已经读完；其他错误说明输入或读取过程异常。
            if errors.Is(err, io.EOF) {
                return nil
            }
            return err
        }
        if delim, ok := tok.(json.Delim); ok {
            // Delim 只描述容器边界，不能当作对象字段值使用。
            fmt.Printf("边界: %q\n", delim)
            continue
        }
        // 字符串可能是对象键，也可能是字符串值，需结合上下文判断。
        fmt.Printf("普通 token: %v\n", tok)
    }
}

Go json.Decoder Token 流分流为普通值、字段名和 json.Delim 的说明图 — 图1：Token 分流说明图，展示普通值与容器分隔符的处理边界。

遇到 json.Delim('{') 或 json.Delim('[') 时，说明后续 token 属于新容器；遇到右分隔符则说明对应容器收口。顶层读取结束时建议用 errors.Is(err, io.EOF) 判断，而不是比较错误字符串。

用深度计数找到嵌套容器的结束位置

如果只关心最外层数组或对象，可以记录进入时的深度。每个左分隔符让深度加一，每个右分隔符让深度减一；当深度回到进入前的数值时，目标容器就读完了。Token 本身保证返回的分隔符具有正确嵌套关系，应用代码主要负责决定在哪一层停止。

func consumeContainer(dec *json.Decoder) error {
    first, err := dec.Token()
    if err != nil {
        return err
    }
    opening, ok := first.(json.Delim)
    if !ok || (opening != '{' && opening != '[') {
        return fmt.Errorf("expected container, got %v", first)
    }

    depth := 1
    for depth > 0 {
        tok, err := dec.Token()
        if err != nil {
            // 容器尚未闭合就遇到 EOF，说明输入被截断。
            return err
        }
        delim, ok := tok.(json.Delim)
        if !ok {
            // 普通值不会改变嵌套层级，继续读取下一个 token。
            continue
        }
        switch delim {
        case '{', '[':
            // 新容器进入一层，内部的边界由同一个计数器跟踪。
            depth++
        case '}', ']':
            // 右分隔符关闭当前容器，回到零即完成目标容器。
            depth--
        }
    }
    return nil
}