go 的 encoding/xml 包要求结构体字段必须导出（首字母大写）才能被 xml.unmarshal 访问，否则属性值将为空字符串；同时需正确配置 struct tag 以匹配 xml 命名空间和属性名。
go 的 encoding/xml 包要求结构体字段必须导出（首字母大写）才能被 xml.unmarshal 访问，否则属性值将为空字符串；同时需正确配置 struct tag 以匹配 xml 命名空间和属性名。
在 Go 中使用标准库 encoding/xml 解析 XML 属性时，一个常见却容易被忽略的关键点是：结构体字段必须是导出的（即首字母大写），否则 xml.Unmarshal 无法反射访问该字段，导致属性值始终为空。
例如，原始代码中定义了如下结构体：
type Message struct {
XMLName xml.Name `xml:"http://www.ncpdp.org/schema/SCRIPT Message"`
release string `xml:"release,attr"` // ❌ 小写字段：未导出，不可见
version string `xml:"version,attr"` // ❌ 同样未导出
}
尽管 struct tag 语法正确（xml:"xxx,attr" 表示提取同名属性），但由于 release 和 version 是小写字段，属于包级私有成员，xml 包（位于 encoding/xml 包内）无法通过反射读写它们——这是 Go 的可见性规则决定的，与 XML 命名空间或解析逻辑无关。
✅ 正确做法是将字段名改为大写，并保持 tag 中的属性名小写（XML 属性名本身是大小写敏感的，但 tag 中的字符串应严格匹配 XML 中的属性名）：
type Message struct {
XMLName xml.Name `xml:"http://www.ncpdp.org/schema/SCRIPT Message"`
Release string `xml:"release,attr"` // ✅ 导出字段，可被 Unmarshal 访问
Version string `xml:"version,attr"` // ✅ 同理
}
完整可运行示例：
package main
import (
"encoding/xml"
"fmt"
)
type Message struct {
XMLName xml.Name `xml:"http://www.ncpdp.org/schema/SCRIPT Message"`
Release string `xml:"release,attr"`
Version string `xml:"version,attr"`
}
func main() {
data := `<message xmlns="http://www.ncpdp.org/schema/SCRIPT" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" release="006" version="010"></message>`
var msg Message
err := xml.Unmarshal([]byte(data), &msg)
if err != nil {
panic(err)
}
fmt.Printf("Release: %s, Version: %s\n", msg.Release, msg.Version)
// 输出：Release: 006, Version: 010
}
⚠️ 注意事项：
- XMLName 字段用于显式声明命名空间和元素名，其 tag 中的命名空间 URI 必须与 XML 中 xmlns 值完全一致（包括末尾斜杠）；
- 属性名（如 "release"）区分大小写，需与 XML 源中完全一致；
- 若 XML 中存在默认命名空间（xmlns="..."），所有子元素默认归属该空间，因此顶层元素的 XMLName 必须包含该命名空间，否则解析可能失败或静默跳过；
- 所有参与 XML 映射的字段必须导出（大写首字母），这是 Go 反射机制的硬性要求，与 xml 包实现无关。
总结：解析 XML 属性的核心前提不是 tag 写法有多“高级”，而是先确保结构体字段满足 Go 的导出规则——这是绝大多数初学者遇到空值问题的根本原因。
