本文旨在帮助开发者解决在使用 Go 语言的 encoding/xml 包进行 XML 解析时，结构体字段无法被正确识别的问题。通过分析常见原因，并结合示例代码，提供清晰的解决方案，确保 XML 数据能够成功映射到 Go 结构体中，以及 Go 结构体能够正确序列化为 XML 数据。
在使用 Go 语言的 encoding/xml 包进行 XML 数据的解析和序列化时，有时会遇到结构体字段无法被正确识别的问题。这通常会导致 XML 数据无法正确映射到 Go 结构体，或者 Go 结构体无法正确序列化为 XML 数据。下面将详细介绍导致该问题的原因以及相应的解决方案。
问题原因：未导出结构体字段
Go 语言的可见性规则是导致此问题的最常见原因。encoding/xml 包只能访问和操作已导出的结构体字段。这意味着字段名称必须以大写字母开头。如果字段名称以小写字母开头，则该字段被认为是未导出的，encoding/xml 包将无法访问它。
解决方案：导出结构体字段
要解决此问题，只需将结构体字段的名称更改为以大写字母开头即可。例如，将 lang string 更改为 Lang string。
示例代码
以下示例代码展示了如何正确定义结构体，以便 encoding/xml 包可以正确解析和序列化 XML 数据。
package main
import (
"encoding/xml"
"fmt"
"io/ioutil"
)
type String struct {
XMLName xml.Name `xml:"STRING"`
Lang string `xml:"lang,attr"`
Value string `xml:"value,attr"`
}
type Entry struct {
XMLName xml.Name `xml:"ENTRY"`
Id string `xml:"id,attr"`
Strings []String `xml:"STRING"` // 注意这里，如果XML中有多个STRING，需要使用slice
}
type Dictionary struct {
XMLName xml.Name `xml:"DICTIONARY"`
Type string `xml:"type,attr"`
Ignore string `xml:"ignore,attr"`
Entries []Entry `xml:"ENTRY"` // 注意这里，如果XML中有多个ENTRY，需要使用slice
}
func main() {
dict := Dictionary{}
b := []byte(`<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DICTIONARY type="multilanguage" ignore="en">
<ENTRY id="ActionText.Description.AI_ConfigureChainer">
<STRING lang="en" value="ActionText.Description.AI_ConfigureChainer"/>
<STRING lang="da" value=""/>
<STRING lang="nl" value=""/>
<STRING lang="fi" value=""/>
</ENTRY>
</DICTIONARY>
`)
err := xml.Unmarshal(b, &dict)
if err != nil {
panic(err)
}
fmt.Printf("%+v\n", dict)
dict.Ignore = "test"
out, err := xml.MarshalIndent(&dict, " ", " ")
if err != nil {
panic(err)
}
fmt.Println(string(out))
}代码解释：
- 结构体字段导出： String、Entry 和 Dictionary 结构体中的所有字段（Lang、Value、Id、Type、Ignore、Strings、Entries）都以大写字母开头，因此它们都是导出的。
- XML 标签： 每个结构体字段都有一个 xml 标签，用于指定该字段对应的 XML 元素或属性的名称。例如，Lang string \xml:"lang,attr"`表示Lang字段对应于 XML 元素的lang` 属性。
- slice类型: 如果XML中存在多个相同名称的元素，需要使用slice。 例如，Strings []String \xml:"STRING"`表示一个Entry元素可以包含多个STRING` 子元素。
注意事项
- 确保 XML 文件的格式正确，并且 XML 标签与结构体字段的 xml 标签匹配。
- 如果 XML 数据包含命名空间，则需要在结构体字段的 xml 标签中指定命名空间。
- 使用 xml.MarshalIndent 函数可以生成格式化的 XML 输出，方便调试和阅读。
总结
通过导出结构体字段，可以解决 Go 语言 encoding/xml 包无法识别结构体字段的问题。在定义结构体时，务必确保所有需要被 XML 解析和序列化的字段都以大写字母开头。同时，也要注意 XML 标签的匹配和命名空间的处理，以确保 XML 数据的正确解析和序列化。
