Go语言中如何优雅地生成并写入XML文件

package main

import (
    "encoding/xml"
)

// Card 结构体代表一个XML卡片元素
type Card struct {
    XMLName xml.Name `xml:"card"` // 定义根元素的名称为 card
    Entity  string   `xml:"entity,attr"` // Entity 字段映射为 card 元素的 entity 属性
    Facts   Facts    `xml:"facts"`       // Facts 字段映射为 facts 子元素
}

// Facts 结构体代表一个XML事实集合元素
type Facts struct {
    XMLName xml.Name `xml:"facts"` // 定义元素的名称为 facts
    Fact    []Fact   `xml:"fact"`  // Fact 字段是一个 Fact 结构体切片，映射为多个 fact 子元素
}

// Fact 结构体代表一个XML事实元素
type Fact struct {
    XMLName  xml.Name `xml:"fact"`    // 定义元素的名称为 fact
    Property string   `xml:"property,attr"` // Property 字段映射为 fact 元素的 property 属性
    Value    string   `xml:",chardata"`     // Value 字段映射为 fact 元素的字符数据内容
}

// ... (接上文的结构体定义)

func main() {
    // 创建一个Card数据实例
    cardData := &Card{
        Entity: "1234id",
        Facts: Facts{
            Fact: []Fact{
                {Property: "prop1", Value: "val1"},
                {Property: "prop2", Value: "val2"},
                {Property: "prop3", Value: "val with <special> & chars"}, // 演示特殊字符处理
            },
        },
    }

    // ... (后续将数据写入文件)
}

package main

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

// ... (接上文的结构体定义和 main 函数开始部分)

func main() {
    cardData := &Card{
        Entity: "1234id",
        Facts: Facts{
            Fact: []Fact{
                {Property: "prop1", Value: "val1"},
                {Property: "prop2", Value: "val2"},
                {Property: "prop3", Value: "val with <special> & chars"},
            },
        },
    }

    // 指定要写入的XML文件路径
    filePath := "output.xml"

    // 创建文件。如果文件已存在，会被截断。
    // os.Create 返回一个 *os.File 类型，它实现了 io.Writer 接口。
    file, err := os.Create(filePath)
    if err != nil {
        fmt.Printf("Error creating file: %v\n", err)
        return
    }
    // 确保文件在函数退出时关闭，释放资源。
    defer func() {
        if closeErr := file.Close(); closeErr != nil {
            fmt.Printf("Error closing file: %v\n", closeErr)
        }
    }()

    // 创建一个新的XML编码器，它会将数据写入到 'file' 中。
    encoder := xml.NewEncoder(file)

    // 设置编码器以生成带缩进的XML，提高可读性。
    encoder.Indent("", "  ") // 第一个参数是前缀，第二个参数是每个缩进级别的字符串

    // 将Go数据结构编码为XML并写入文件。
    if err := encoder.Encode(cardData); err != nil {
        fmt.Printf("Error encoding XML: %v\n", err)
        return
    }

    fmt.Printf("XML data successfully written to %s\n", filePath)
}

<card entity="1234id">
  <facts>
    <fact property="prop1">val1</fact>
    <fact property="prop2">val2</fact>
    <fact property="prop3">val with <special> & chars</fact>
  </facts>
</card>