当前位置：首页 > 文章列表 > Golang > Go问答 > Go encoding/xml 解码 Token 时如何识别嵌套结束标签

Go encoding/xml 解码 Token 时如何识别嵌套结束标签

来源：17golang原创 2026-09-09 19:53:21 0浏览收藏

Go encoding/xml 解码 Token 时如何识别嵌套结束标签

用 xml.Decoder.Token() 流式读 XML 时，真正容易出错的不是拿到 EndElement，而是判断它结束了哪一层。结论是：让解码器负责保证 XML 令牌合法，应用自己维护一个 []xml.Name 栈；开始标签入栈，结束标签必须和栈顶的 Space + Local 完整匹配后再出栈。

要点速览

Token 返回的是类型化令牌，不要把结束标签当普通字符串处理。
嵌套边界靠栈顶判断；只比较 Local 可能误混命名空间。
正常结束是栈为空后收到 io.EOF，提前 EOF 和 Token 错误都要单独处理。

先分清 Token、StartElement 与 EndElement 的边界

Token 返回的接口值可能是 xml.StartElement、xml.EndElement、xml.CharData、注释、处理指令或指令节点。遇到输入末尾时，它返回 nil, io.EOF。自闭合标签例如也会被展开为连续的开始和结束令牌，所以不能把“看见开始标签”直接当成有子节点。

Go encoding/xml Token、StartElement、EndElement、xml.Name 与 io.EOF 的静态关系图 — 图1：看清 Token 可能承载的令牌类型，以及自闭合元素对应的开始与结束令牌。

标准库的 Token 会保证开始与结束元素正确嵌套；如果遇到意外结束标签，或输入在所有元素结束前就 EOF，会返回错误。这个保证解决了“XML 是否合规”，却没有替应用回答“当前结束的是我关心的哪一个节点”。后一个问题要用深度或栈解决。

用栈追踪嵌套结束标签，别只比较 Local

下面的遍历器把每个开始标签压入栈，遇到结束标签时检查栈顶。示例没有运行外部命令，只展示流式读取时的边界逻辑；真实业务可以在开始标签处决定是否读取属性，在结束标签处提交一个完整节点。

package main

import (
    "encoding/xml"
    "fmt"
    "io"
)

func walkXML(r io.Reader) error {
    dec := xml.NewDecoder(r)
    stack := make([]xml.Name, 0, 8)

    for {
        tok, err := dec.Token()
        if err == io.EOF {
            // 只有所有开始标签都已闭合，EOF 才代表正常结束。
            if len(stack) != 0 {
                return fmt.Errorf("XML 提前结束，仍有 %d 层未闭合", len(stack))
            }
            return nil
        }
        if err != nil {
            // 语法错误、字符集错误等由 Token 原样交给调用方处理。
            return err
        }

        switch t := tok.(type) {
        case xml.StartElement:
            // Name 同时保留命名空间和本地名，避免同名元素混层。
            stack = append(stack, t.Name)

        case xml.EndElement:
            if len(stack) == 0 {
                return fmt.Errorf("多出的结束标签: %s", t.Name.Local)
            }
            opened := stack[len(stack)-1]
            if opened != t.Name {
                return fmt.Errorf("结束标签 %s 与开始标签 %s 不匹配", t.Name.Local, opened.Local)
            }
            // 栈顶就是当前 EndElement 对应的开始标签。
            stack = stack[:len(stack)-1]
        }
    }
}

判断重点有三个。第一，EndElement 只能和栈顶比较，不能在整个栈里搜索一个“看起来一样”的名称，否则错误结构会被掩盖。第二，xml.Name 的 Space 是命名空间标识，Local 才是本地名；两者一起比较才是完整身份。第三，io.EOF 不是“读到一半也算成功”，它只有在栈已经为空时才表示完整文档结束。

Go xml.Decoder 使用 xml.Name 栈匹配嵌套 StartElement 和 EndElement 的关系图 — 图2：栈顶把 StartElement 与对应 EndElement 绑定，Space 和 Local 共同构成标签身份。

用深度判断目标节点，用完整名称确认安全边界

如果业务只关心某个节点，可以在命中开始标签时记录当前栈深度，之后只处理同一层级的字段；当栈顶名称匹配并回到记录开始前的深度时，才提交这条记录。不要只用一个布尔值，因为 record 内还可能嵌套另一个同名元素。

现象	判断	处理
收到 StartElement	进入一层嵌套	保存 Name 并压栈
收到 EndElement	结束当前栈顶	比较 Space、Local 后出栈
收到 io.EOF	文档是否完整取决于栈	空栈才返回成功

还要注意令牌中的字节切片只在下一次调用 Token 前有效。如果要把字符数据或令牌留到后面处理，应复制它；只保存 xml.Name 这类字符串字段则不会遇到同样的内部缓冲区生命周期问题。