XQuery原生不支持更新XML文件，因其是无副作用的函数式查询语言；所谓更新均依赖引擎扩展（如BaseX的ad:replace、eXist-db的update:replace）或外部程序配合“读取→修改→写回”实现。
XQuery 本身是只读查询语言，XQuery 标准（包括 XPath 3.1、XQuery 3.1）**不支持直接修改 XML 文档或“更新上传的文件”**。所谓“用 XQuery 更新 XML”，实际依赖具体引擎的扩展语法（如 BaseX 的 ad:replace、eXist-db 的 xmldb:store + update 模块），或必须配合外部程序逻辑完成“读取 → 修改 → 写回”三步操作。
为什么原生 XQuery 不能更新文件
这是设计使然：XQuery 被定义为函数式、无副作用的查询语言。它处理的是序列和节点流，不持有对底层存储的引用，也不提供写入磁盘、覆盖文件等 I/O 操作能力。
- 所有声称“XQuery 更新”的功能，都来自具体实现的私有扩展（非 W3C 标准）
-
浏览器、
curl、标准xmlstar或saxon命令行（默认模式）均不支持就地修改 - 常见错误：把
replace()字符串函数误当作节点替换 —— 它只作用于字符串值，不改变 XML 结构
BaseX 中用 ad:replace 修改内存中 XML 并保存
BaseX 提供 ad:replace（在 http://basex.org/modules/adhoc 命名空间下）用于替换匹配节点，但仅限当前数据库或内存文档；要“更新上传的文件”，仍需显式调用 db:store() 或导出到磁盘。
import module namespace ad = "http://basex.org/modules/adhoc";
<p>let $doc := doc("uploaded.xml")
let $updated := ad:replace($doc, "//title", <title>New Title</title>)
return db:store("uploaded.xml", $updated)-
ad:replace第二个参数是 XPath 表达式，第三个是新节点（可为元素、文本或序列） -
db:store()会覆盖同名数据库资源；若操作的是本地文件，需先用db:open("uploaded.xml")或确保该文件已在数据库中注册 - 若文件未入库，应改用
file:write("uploaded.xml", serialize($updated))（需启用file模块且权限允许）
eXist-db 的 update:replace + xmldb:store 流程
eXist-db 使用 update:replace（在 http://exist-db.org/xquery/update 下）修改数据库内文档，再通过 xmldb:store() 同步到文件系统（若启用了文件系统同步）。
import module namespace update="http://exist-db.org/xquery/update";
import module namespace xmldb="http://exist-db.org/xquery/xmldb";
<p>let $doc := doc("/db/uploaded.xml")
return (
update:replace($doc//price, <price>99.99</price>),
xmldb:store("/db", "uploaded.xml", $doc)
)-
update:replace是原子性操作，但仅影响数据库缓存中的副本 -
xmldb:store()第一个参数是集合路径（如/db），第二个是文件名，第三个是内容；它不会自动读取修改后的 $doc，所以上例中实际未保存变更 —— 正确做法是先构造新文档再 store - 更安全写法：用
util:document-element()获取根节点后重建，或直接用file:write()输出序列化结果
通用安全方案：XQuery 查询 + 外部工具写回
最可靠、跨平台的方式是：用 XQuery 提取目标节点位置/值 → 用 Python/Shell/Java 等做结构化修改 → 写回原文件。例如用 saxon 提取节点路径，再用 xmlstar 替换：
# 先用 Saxon 获取待更新节点的 XPath（示例） saxon -s:uploaded.xml -xsl:get-path.xsl -o:path.txt <h1>再用 xmlstar 就地替换（需确认 xmlstar 支持 --inplace）</h1><p>xmlstar --inplace --update "//config/@env" --value "prod" uploaded.xml
-
xmlstar的--inplace参数并非所有版本都支持（旧版需重定向：xmlstar ... > tmp.xml && mv tmp.xml uploaded.xml） - 若节点内容含特殊字符（如
&、<），xmlstar --update可能失败；此时建议用 Python 的lxml或xml.etree.ElementTree - 任何“写回”操作前，务必先备份原文件 —— XML 解析失败或编码错误极易导致文件损坏
真正容易被忽略的点：你以为在“更新 XML”，其实是在管理三个分离环节——查询表达式的准确性、目标节点的上下文唯一性（比如 //item[1] 在不同文档中含义可能漂移）、以及写回时的编码与格式保持（缩进、声明、命名空间前缀）。这些细节不出现在 XQuery 语句里，却决定成败。
