本文详解在 go 中使用 gokogiri 解析含默认命名空间（xmlns="..."）的 xml 时的关键步骤：必须显式注册命名空间前缀并将其用于 xpath 表达式，否则节点将无法匹配。
在使用 gokogiri（Moovweb 维护的 libxml2 Go 封装）解析 XML 时，若文档声明了默认命名空间（如 <NodeA xmlns="http://example.com/this">），即使没有显式前缀，该命名空间仍会作用于所有未加前缀的子元素。此时，直接使用 .//NodeA/NodeB 这类无命名空间的 XPath 是无效的——libxml2 会严格按命名空间语义匹配，而未注册前缀的表达式默认匹配空命名空间（即无 xmlns 声明的文档），导致搜索结果为空。
正确做法是：
- 获取 XPath 上下文对象：调用 doc.DocXPathCtx() 获取底层 xmlXPathContextPtr；
- 注册命名空间前缀：使用 xp.RegisterNamespace("ns", "http://example.com/this") 将任意前缀（如 "ns"）绑定到目标命名空间 URI；
- 在 XPath 中显式使用该前缀：例如 /ns:NodeA/ns:NodeB 或 //ns:NodeB，确保路径与命名空间严格对应。
以下是完整可运行示例：
package main
import (
"fmt"
"github.com/moovweb/gokogiri"
"github.com/moovweb/gokogiri/xpath"
)
func main() {
xmlWithNS := `<?xml version="1.0"?>
<NodeA xmlns="http://example.com/this">
<NodeB>thisthat</NodeB>
<NodeB>hello</NodeB>
</NodeA>`
doc, err := gokogiri.ParseXml([]byte(xmlWithNS))
if err != nil {
panic(err)
}
defer doc.Free()
// ✅ 关键：获取 XPath 上下文并注册命名空间
xp := doc.DocXPathCtx()
xp.RegisterNamespace("ns", "http://example.com/this")
// ✅ 关键：XPath 必须包含已注册的前缀
x := xpath.Compile("//ns:NodeB")
nodes, err := doc.Search(x)
if err != nil {
fmt.Printf("XPath error: %v\n", err)
return
}
fmt.Printf("Found %d NodeB elements:\n", len(nodes))
for i, node := range nodes {
fmt.Printf("%d: %s\n", i, node.Content())
}
}输出：
Found 2 NodeB elements: 0: thisthat 1: hello
⚠️ 注意事项：
- doc.SetNamespace("", "...") 无效——gokogiri 的 XmlDocument 不提供此方法，且 libxml2 中“空前缀”不等价于默认命名空间；
- xpath.Expression 类型无 RegisterNamespace 方法，命名空间必须在 xmlXPathContext 级别注册；
- 前缀名（如 "ns"）可自由选择，唯一要求是其绑定的 URI 必须与 XML 中 xmlns="..." 的值完全一致（包括末尾斜杠、大小写）；
- 若 XML 使用带前缀的命名空间（如 <ns:NodeA xmlns:ns="...">），仍需按相同方式注册，并在 XPath 中使用该前缀。
总结：处理命名空间不是“可选项”，而是 libxml2 的强制语义。gokogiri 要求开发者显式桥接 XML 命名空间与 XPath 查询逻辑——通过 DocXPathCtx() + RegisterNamespace() + 带前缀 XPath 三步组合，即可稳健解析任意命名空间场景。
