本文详解如何使用 Go 的 encoding/xml 包递归解析任意层级嵌套的 OPML 文档，核心在于为嵌套结构定义自引用指针字段，并避免 XML 解析时因结构不匹配导致的静默截断。
本文详解如何使用 go 的 `encoding/xml` 包递归解析任意层级嵌套的 opml 文档，核心在于为嵌套结构定义自引用指针字段，并避免 xml 解析时因结构不匹配导致的静默截断。
OPML（Outline Processor Markup Language）是一种常用于订阅源（如 RSS/Atom）列表交换的 XML 格式。其典型特征是 <outline> 元素可无限嵌套——父节点下可包含多个子 <outline>，形成树状结构。若使用固定结构体（如 Outline Outline 字段）解析，Go 的 XML 解包器仅能捕获第一个子节点，其余被忽略；而若直接声明为切片（[]Outline），又无法表达“每个 outline 可继续嵌套”的递归语义。
正确的做法是：将嵌套字段声明为自引用指针类型，即 *Outline，并配合 xml:"outline" 标签。这样，XML 解析器在遇到子 <outline> 时会自动为其分配新实例并递归解包，从而完整还原整棵树。
以下是完整、可运行的解决方案：
package main
import (
"encoding/xml"
"fmt"
)
var response = `<opml version='1.0'>
<head>
<title>More Cases</title>
<expansionState>1,6,26</expansionState>
</head>
<body>
<outline text='Testing' _note='indeterminate'>
<outline text='Weekly' _status='indeterminate'>
<outline text='Mon' />
<outline text='Tue' _note='important' />
</outline>
<outline text='Monthly' />
</outline>
</body>
</opml>`
type Opml struct {
XMLName xml.Name `xml:"opml"`
Version string `xml:"version,attr"`
Head Head `xml:"head"`
Body Body `xml:"body"`
}
type Head struct {
Title string `xml:"title"`
ExpansionState string `xml:"expansionState"`
}
type Body struct {
Outline *Outline `xml:"outline"` // 注意：此处必须为指针，否则仅解析首层
}
// Outline 支持无限递归嵌套
type Outline struct {
Text string `xml:"text,attr"`
Note string `xml:"_note,attr"`
Status string `xml:"_status,attr"`
Outline *Outline `xml:"outline"` // ✅ 自引用指针，实现递归解析
// 若需支持同级多个 outline（更常见场景），应改为：
// Children []*Outline `xml:"outline"`
}
func (o *Outline) String() string {
return fmt.Sprintf("Outline{Text: %q, Note: %q, Status: %q}", o.Text, o.Note, o.Status)
}
// 辅助方法：以缩进形式打印整棵树（便于验证解析结果）
func (o *Outline) Print(indent string) {
if o == nil {
return
}
fmt.Printf("%s%s\n", indent, o.String())
if o.Outline != nil {
o.Outline.Print(indent + " ")
}
}
func main() {
opml := &Opml{}
err := xml.Unmarshal([]byte(response), opml)
if err != nil {
panic(err)
}
fmt.Println("Parsed OPML:")
fmt.Printf("Version: %s, Title: %s\n", opml.Version, opml.Head.Title)
if opml.Body.Outline != nil {
fmt.Println("Outline tree:")
opml.Body.Outline.Print(" ")
} else {
fmt.Println("No outline found.")
}
}⚠️ 关键注意事项：
- Outline 字段*必须为指针类型 `Outline**，而非值类型Outline或切片[]Outline`。值类型会导致解析器跳过嵌套；切片虽能捕获所有同级节点，但无法自然表达“每个节点自身可再嵌套”的层级关系（除非额外设计 Children 字段）。
- 若实际 OPML 中一个 <outline> 下存在多个同级子 <outline>（这是标准用法），推荐将字段改为 Children []*Outlinexml:"outline"`，并在结构体中显式管理子节点列表——这更符合语义且便于遍历。
- 所有 XML 属性（如 _note, _status）需通过 ,attr 显式声明；未声明的属性将被忽略，不会报错。
- 使用 xml:"outline" 而非 xml:"outline>" —— 后者是无效标签语法。
通过上述结构设计，即可稳健、清晰地解析任意深度嵌套的 OPML 文档，为后续构建目录树、导出为 JSON 或渲染前端层级菜单等场景奠定坚实基础。
