本文详解 Go 语言中解析典型 RETS 协议 XML 的方法，包括结构体定义技巧、encoding/xml 包的正确用法、常见错误规避，并推荐实用工具辅助生成结构体。
本文详解 go 语言中解析典型 rets 协议 xml 的方法，包括结构体定义技巧、encoding/xml 包的正确用法、常见错误规避，并推荐实用工具辅助生成结构体。
Go 原生的 encoding/xml 包功能强大但对 XML 结构敏感，稍有不慎就会解析失败。以你提供的 RETS XML 片段为例：
<?xml version="1.0" standalone="no"?><rets replycode="0" replytext="Operation Successful"><count records="58951"></count><delimiter value="09"></delimiter><columns> LN </columns><data> 09361303 </data><data> 09333085 </data><maxrows></maxrows></rets>
✅ 正确的结构体定义方式
你的原始定义存在两个关键问题：
-
DATA字段不应嵌套为独立结构体（除非需额外属性），直接映射为[]string更简洁； -
xml:"RETS>DATA"路径语法在Unmarshal中不生效——Go 的xml包仅支持一级标签路径（如xml:"DATA"），不支持嵌套路径选择器（类似 CSS 或 XPath）。父级结构需通过嵌套字段体现层级。
修正后的结构体应如下：
type Rets struct {
XMLName xml.Name `xml:"RETS"`
ReplyCode string `xml:"ReplyCode,attr"`
ReplyText string `xml:"ReplyText,attr"`
Count Count `xml:"COUNT"`
Delimiter Delimiter `xml:"DELIMITER"`
Columns string `xml:"COLUMNS"`
Data []string `xml:"DATA"` // 直接提取所有 <data> 文本内容
MaxRows struct{} `xml:"MAXROWS"` // 空结构体表示存在该标签
}
type Count struct {
Records string `xml:"Records,attr"`
}
type Delimiter struct {
Value string `xml:"value,attr"`
}</data>
✅ 解析示例代码
package main
import (
"encoding/xml"
"fmt"
"strings"
)
func main() {
xmlData := `<?xml version="1.0" standalone="no"?><rets replycode="0" replytext="Operation Successful"><count records="58951"></count><delimiter value="09"></delimiter><columns> LN </columns><data> 09361303 </data><data> 09333085 </data><maxrows></maxrows></rets>`
var rets Rets
err := xml.Unmarshal([]byte(xmlData), &rets)
if err != nil {
panic(err)
}
fmt.Printf("Reply: %s (%s)\n", rets.ReplyText, rets.ReplyCode)
fmt.Printf("Total records: %s\n", rets.Count.Records)
fmt.Printf("Delimiter: %s\n", rets.Delimiter.Value)
fmt.Printf("Columns: '%s'\n", strings.TrimSpace(rets.Columns))
fmt.Println("Data entries:")
for i, d := range rets.Data {
fmt.Printf(" [%d] '%s'\n", i+1, strings.TrimSpace(d))
}
}
输出：
Reply: Operation Successful (0) Total records: 58951 Delimiter: 09 Columns: 'LN' Data entries: [1] '09361303' [2] '09333085'
⚠️ 关键注意事项
-
文本内容需手动 trim：XML 中
<data> 09361303 </data>的前后空格会被原样保留，务必使用strings.TrimSpace()清理。 -
属性与内容分离：用
,attr标签读取属性（如ReplyCode），用,chardata（或默认）读取文本节点；若需同时读取标签内容和属性，需定义嵌套结构体。 -
空标签处理：如
<maxrows></maxrows>可用struct{}或bool类型配合xml:",omitempty"控制序列化，但反序列化时仅检测是否存在。 -
命名冲突规避：Go 中字段名须大写导出，XML 标签名大小写需严格匹配（如
<columns></columns>→Columns string是安全的，但columns不会匹配）。
?️ 辅助工具推荐：zek
对于复杂或未知结构的 XML（如完整 RETS 响应含 METADATA-TABLE、COMPONENT 等嵌套），手动编写结构体易出错。推荐使用 zek 工具（命令行版 XML-to-Go 转换器）：
# 直接从 URL 生成结构体（支持管道输入） curl -sL https://git.io/fN4Pq | zek -e -p -c # 或本地文件 zek -e -p -c rets.xml
它会自动生成带注释的 Go 结构体、示例解析代码及 JSON 序列化逻辑，大幅提升开发效率。
? 小贴士：
zek输出的结构体已预设好常用字段标签（如xml:",chardata"、xml:",attr"），并按 XML 层级自动嵌套，避免手写路径错误。
掌握结构体标签语义 + 工具辅助 + 文本后处理，Go 解析 XML 就不再“想回 Node.js”——而是稳、准、快。
