XSLT可重用性取决于隔离数据依赖、避免硬编码路径及正确处理上下文,而非语法存在;函数适合无状态计算,命名模板需显式传参,模块化推荐import/include,XSLT 3.0的package支持封装但兼容性差。

XSLT 2.0+ 支持命名模板(<xsl:template name="...">)和用户定义函数(<xsl:function>),但可重用性不取决于语法是否存在,而取决于是否隔离了数据依赖、避免硬编码路径、正确处理上下文切换——尤其在跨模块调用时。
用 <xsl:function> 替代 <xsl:template name="..."> 处理纯计算逻辑
命名模板本质是“带参数的跳转”,执行时会改变当前上下文节点(.)、影响 <xsl:apply-templates> 流程;而函数必须显式声明参数、返回值类型,且禁止副作用(如输出、修改全局变量)。适合字符串处理、数值转换、布尔判断等无状态操作。
- ✅ 推荐:把日期格式化、XML ID 生成规则、XPath 路径拼接写成
<xsl:function> - ❌ 避免:在函数里调用
<xsl:apply-templates>或依赖未传入的全局变量$config - ⚠️ 注意:XSLT 1.0 不支持
<xsl:function>,若需兼容,只能用命名模板 + 显式传入select="."来模拟
<xsl:function name="my:slugify" as="xs:string"> <xsl:param name="input" as="xs:string"/> <xsl:sequence select="replace(normalize-space($input), '[^a-z0-9]+', '-')"/> </xsl:function>
命名模板中用 <xsl:with-param> 显式传递所有依赖项
命名模板常用于复用 UI 片段(如表格行、错误提示块),但容易因隐式依赖当前上下文出错。比如模板内写 <xsl:value-of select="title"/>,调用时若上下文不是预期元素,就会取空。
- ✅ 必须:所有外部数据都通过
<xsl:with-param>传入,哪怕只用一次 - ✅ 建议:为参数设默认值(
select="''"或select="/empty"),降低调用方负担 - ⚠️ 常见坑:用
<xsl:param name="node" select="."/>试图“捕获当前节点”,但若模板被<xsl:for-each>内调用,.已变,应改用select="current()"
<xsl:template name="render-author">
<xsl:param name="person" select="."/>
<div class="author">
<span><xsl:value-of select="$person/name"/></span>
<span><xsl:value-of select="$person/email"/></span>
</div>
</xsl:template>
<p><!-- 调用时显式传参 -->
<xsl:call-template name="render-author">
<xsl:with-param name="person" select="//author[1]"/>
</xsl:call-template>用 <xsl:import> 和 <xsl:include> 管理模块边界
<xsl:import> 允许覆盖被导入模板(优先级低),适合构建可定制的基础库;<xsl:include> 是文本合并,无优先级,适合拆分大型样式表。两者都不支持“作用域隔离”——所有全局变量、函数、模板都在同一命名空间。
- ✅ 实践:将通用工具函数(
my:deep-copy、my:has-ancestor)放在utils.xsl中,用<xsl:import href="utils.xsl"/> - ⚠️ 关键限制:无法限定“只导出某几个函数”,也无法防止命名冲突。若两个导入文件都定义了
my:format-date,后导入的会覆盖前一个 - ? 折中方案:约定前缀(如
str:trim、xml:find-root)并在文档中标明来源模块
XSLT 3.0 的 <xsl:package> 是唯一真正支持封装的机制
只有 XSLT 3.0 引入了模块化标准:<xsl:package> 可声明可见性(visibility="public" / "private")、导出接口(<xsl:export>)、依赖版本。但实际采用率极低——Saxon-EE 支持,但 libxslt、MSXML、浏览器引擎均不支持。
- ✅ 若环境可控(如 Java 后端强制用 Saxon-EE),可用
<xsl:package name="com:example:core">封装高复用逻辑 - ❌ 别在 Web 前端或遗留系统中尝试,会直接失败
- ⚠️ 最易忽略的一点:即使用了
<xsl:package>,函数内部仍不能访问调用方的局部变量,所有通信仍靠参数传递——封装 ≠ 共享作用域
真正的可重用性不来自语法糖,而来自每次调用前问一句:“如果我把这个模板/函数剪出来放到另一个项目里,它还跑得通吗?”——答案是否定的,大概率是因为它偷偷读了某个没传进来的变量,或者依赖了特定的文档结构层级。


















