base-uri() 返回当前上下文节点的基本 URI:文档节点返回文档URI,其他节点继承最近xml:base或祖先URI,动态节点默认为空序列;常与resolve-uri()配合解析相对路径。

base-uri() 是 XSLT 2.0 及更高版本(包括 XSLT 3.0)中用于获取当前节点**基本 URI(Base URI)** 的内置函数。它返回一个字符串,表示该节点在解析时所依据的 URI(通常是文档或片段的来源地址),对处理相对路径、解析 xlink:href、xml:base 或生成绝对链接非常有用。
base-uri() 返回什么
它返回当前上下文节点的 base URI,具体取决于节点类型:
- 对于文档节点(
/),通常返回整个 XML 文档的 URI(如file:///path/to/doc.xml或https://example.com/data.xml); - 对于元素、属性、文本等节点,继承其最近的祖先(含自身)声明的
xml:base属性值; - 如果没有显式
xml:base,就沿用父元素或文档的 base URI; - 对临时构造的节点(如
动态创建的),base URI 默认为()(空序列),除非显式用xsl:copy+select="@*" inherit-namespaces="yes"等方式保留。
常见用法示例
假设你有如下 XML:
html"/>
对应 XSLT 片段:
输出可能为:
https://example.com/base/ + page.htmlhttps://example.com/base/subdir/ + inner.xml
注意事项和兼容性
-
XSLT 1.0 不支持 base-uri() —— 它没有该函数。若必须用 1.0,只能靠外部传入 base URI(如通过
),或依赖处理器扩展(如 Saxon 的saxon:base-uri(),但不通用); - 确保使用 XSLT 2.0+ 处理器(如 Saxon-HE/PE/EE、libxslt 1.1.29+、Altova RaptorXML);
- 调用时注意上下文节点:写成
base-uri()默认作用于当前 context node;也可显式指定:base-uri(some-node); - 如果节点没有 base URI(例如内存中构造的文档),函数返回空序列
(),建议配合string()或判断避免报错:string(base-uri())或if (base-uri()) then base-uri() else 'unknown'。
结合 resolve-uri() 构建绝对地址
常与 resolve-uri(@href, base-uri()) 配合,把相对引用转为绝对 URI:
例如 @href="page.html" 在 base 为 https://example.com/base/ 下,结果就是 https://example.com/base/page.html。
基本上就这些。用好 base-uri() 能让 XSLT 更可靠地处理带路径引用的 XML 场景,尤其在聚合、重发布或生成链接时很实用。










