gokogiri 默认不自动处理默认命名空间（xmlns="..."），需显式注册命名空间前缀并用于 xpath 表达式，否则搜索将返回空结果。
在使用 github.com/moovweb/gokogiri 解析带命名空间的 XML 时，一个常见误区是认为 doc.SetNamespace("", "http://example.com/this") 或尝试调用不存在的 RegisterNamespace 方法即可生效。实际上，gokogiri 的 XML 命名空间支持依赖于底层 libxml2 的 XPath 上下文（XPath context），必须通过 doc.DocXPathCtx() 获取上下文对象，并在其上调用 RegisterNamespace(prefix, uri) 才能正确绑定命名空间。
关键点如下：
- ✅ 必须使用 doc.DocXPathCtx().RegisterNamespace()：这是唯一有效的命名空间注册方式；
- ✅ XPath 表达式中必须显式使用注册的前缀：例如注册了 "ns" → 路径需写为 /ns:NodeA/ns:NodeB；
- ❌ doc.SetNamespace("", ...) 无效：该方法仅影响部分 DOM 操作，不作用于 XPath 查询；
- ❌ doc.RegisterNamespace 或 xpath.Expression.RegisterNamespace 不存在：这些方法在 gokogiri v1.x 中未实现，属误查 API。
以下是可直接运行的完整示例：
package main
import (
"fmt"
"github.com/moovweb/gokogiri"
"github.com/moovweb/gokogiri/xpath"
)
func main() {
xml := `<?xml version="1.0" ?><NodeA xmlns="http://example.com/this"><NodeB>thisthat</NodeB></NodeA>`
doc, err := gokogiri.ParseXml([]byte(xml))
if err != nil {
panic(err)
}
defer doc.Free()
// ✅ 步骤 1：获取 XPath 上下文并注册命名空间（前缀可自定义，如 "ns"）
ctx := doc.DocXPathCtx()
ctx.RegisterNamespace("ns", "http://example.com/this")
// ✅ 步骤 2：编写带前缀的 XPath 表达式
expr := xpath.Compile("/ns:NodeA/ns:NodeB")
// ✅ 步骤 3：执行搜索
nodes, err := doc.Search(expr)
if err != nil {
fmt.Printf("XPath error: %v\n", err)
return
}
// 输出匹配节点内容
for i, node := range nodes {
fmt.Printf("%d: %s\n", i, node.Content())
}
}输出结果：
0: thisthat
⚠️ 注意事项：
- 若 XML 中存在多个命名空间（如 xmlns:ns1="..." xmlns:ns2="..."），需为每个 URI 单独调用 RegisterNamespace；
- 前缀名称（如 "ns"）与 XML 中是否实际使用该前缀无关——只需 URI 完全匹配即可；
- gokogiri 已归档（moovweb/gokogiri 自 2017 年起不再维护），生产环境建议迁移到更活跃的替代方案（如 mellium/xml 或原生 encoding/xml + 自定义解析逻辑），但若需兼容遗留代码，上述命名空间方案仍完全有效。
掌握命名空间的显式注册与前缀化 XPath 是使用 gokogiri 处理真实世界 XML（如 SOAP、Atom、RSS、Office Open XML）的关键基础。
