xquery 是独立的函数式查询语言，专为高效提取转换 xml/json/html 设计；支持 flwor、变量绑定、xml 构造等，适用于多条件过滤与结构重组，而 xpath 仅适合简单路径定位。
XQuery 不是 XPath 的升级版，也不是 sql 的 XML 版本——它是一门独立的、函数式查询语言，专为高效提取和转换 XML（以及 JSON、HTML）数据而设计。如果你手头有一堆 XML 文件或一个支持 XQuery 的数据库（如 eXist-db、BaseX、MarkLogic），想按条件筛选节点、聚合值、重组结构，XQuery 比用 dom + 循环写十行代码更直接。
什么时候该用 XQuery 而不是 XPath
XPath 适合“定位单个节点路径”，比如 //book/title/text()；XQuery 则能完成“查出所有 2023 年出版且评分 >4.5 的书，按价格升序排列，只返回标题和作者”。它支持变量绑定、FLWOR 表达式（类似 SQL 的 select-FROM-WHERE）、函数定义、XML 构造，甚至模块化导入。
- 需要多条件组合过滤（不只是路径匹配）→ 用
for+where - 要拼接新 XML 结构（比如把
<author></author>和<title></title>合成<item></item>）→ 用直接构造语法<item>{$x/title}</item> - 处理多个文档或命名空间 → XQuery 1.0+ 支持
doc()函数和declare Namespace - 仅需提取一个简单文本值 → 留给 XPath，别上 XQuery 小题大做
一个真实可用的 XQuery 查询示例
假设有如下 XML 片段（保存为 books.xml）：
<library> <book year="2023"> <title>Learning XQuery</title> <author>Priscilla Walmsley</author> <rating>4.7</rating> </book> <book year="2020"> <title>XML Schema</title> <author>Eric van der Vlist</author> <rating>4.2</rating> </book> </library>执行以下 XQuery（可在 BaseX 或 xqueryfiddle.org 中运行）：
for $b in doc("books.xml")//book where $b/@year = "2023" and xs:decimal($b/rating) > 4.5 order by $b/title return <result> <title>{$b/title/text()}</title> <author>{$b/author/text()}</author> </result>注意几个关键点：
-
doc("books.xml")加载外部文件；若在内存中操作，可改用./books.xml或变量绑定 -
xs:decimal()强制类型转换，避免字符串比较（"4.7" > "4.5"在某些引擎里不成立） -
{$b/title/text()}是“表达式插值”，花括号内必须是有效 XQuery 表达式 - 没写
declare namespace？因为示例无命名空间；一旦 XML 有xmlns="http://example.com"，就必须声明并前缀使用
常见报错和绕过方法
新手常卡在这些地方：
-
XPST0003: Unexpected Token→ 多半是少写了return，或花括号里用了非法表达式（比如{$b/title}缺/text()导致返回元素节点而非字符串） -
FODC0002: Document not found→doc()路径错误；用绝对路径或确认工作目录；BaseX 中优先用db:open("mydb")替代doc() - 结果为空但语法没错 → 检查默认命名空间；加一句
declare default element namespace "";可重置 - 性能慢 → 避免在
where子句里调用函数（如contains($b/title, "XQuery")）做全量扫描；先用路径过滤再加工
真正难的不是语法，而是理解 XQuery 的“序列”模型：一切皆序列（哪怕只有一个节点），空序列是合法值，+ 不拼字符串而是数值相加。习惯这点，很多诡异行为就自然解开了。