XML数据在不同系统间流转时，经常需要借助XSLT样式表将其转换成网页、报文或报表格式。在这个过程中，xsl:variable元素承担着暂存计算结果、节点片段和字符串的重要职责。理解它的定义方式与取值规则，是写出可维护XSLT代码的基础。与Java或Python里的变量不同，XSLT基于函数式转换模型，变量在绑定后就是只读的，这种设计避免了转换过程中的副作用，但也让很多刚接触XSLT的开发者感到困惑。
xsl:variable的基本定义语法与赋值方式
在XSLT中，定义变量必须使用<xsl:variable>元素。它有两个关键属性：name用于指定变量名，select用于通过XPath表达式直接赋值。如果省略select，则变量的内容由元素内部的模板内容决定，可以是文本节点、其他元素甚至通过<xsl:value-of>取出的动态值。需要注意的是，变量名在样式表作用域内必须唯一（针对同一作用域），且命名要符合QName规则。
下面展示两种最常见的定义形式。第一种是利用select直接绑定节点集或字符串，第二种是在标签内部写内容。两者在后续引用时都通过$变量名的方式取值，但底层存储结构略有差异：select得到的是原始表达式的结果，而内部内容会被实例化为一个临时树片段。
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<!-- 方式一：使用select赋值 -->
<xsl:variable name="title" select="'图书清单'"/>
<!-- 方式二：使用内部内容赋值 -->
<xsl:variable name="maxPrice">
<xsl:value-of select="//book[1]/price"/>
</xsl:variable>
<xsl:template match="/">
<h1><xsl:value-of select="$title"/></h1>
<p>首本书价格：<xsl:value-of select="$maxPrice"/></p>
</xsl:template>
</xsl:stylesheet>
上述代码中，字符串常量需要用单引号包裹，这是XPath语法要求。如果漏掉单引号，XSLT处理器会把图书清单当成子元素名去查找，从而引发转换错误。对于从XML取出的数值，推荐优先用select，因为这样不会额外生成文本节点，转换效率更高。
变量的作用域与全局局部差异
变量作用域取决于<xsl:variable>出现的位置。当它作为<xsl:stylesheet>的直接子元素时，成为全局变量，可在所有模板中通过$名称引用；当它嵌套在<xsl:template>或<xsl:for-each>等指令内部时，就是局部变量，仅在对应块内有效。这种分层设计让我们能把通用配置（如网站名称）放在全局，把循环中的临时计算放在局部。
局部变量会遮蔽同名的全局变量，这一点和多数语言类似。但在XSLT里，由于不可变性，你不能在同一个模板里先定义$count再重新给它赋值。如果确实需要不同阶段的数值，应当定义多个不同名的变量，或者把逻辑拆进不同的模板由参数传递。下面例子说明全局与局部共存时的引用规则。
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:variable name="site" select="'技术博客'"/>
<xsl:template match="article">
<xsl:variable name="site" select="'本地文档'"/>
<!-- 此处引用的是局部site，输出本地文档 -->
<div><xsl:value-of select="$site"/></div>
</xsl:template>
<xsl:template match="footer">
<!-- 此处没有局部site，引用全局，输出技术博客 -->
<span><xsl:value-of select="$site"/></span>
</xsl:template>
</xsl:stylesheet>
从维护角度看，滥用全局变量会让样式表难以追踪数据来源。建议仅把真正跨模板共用的常量提取为全局，其余临时数据一律在最小必要范围内定义。此外，XSLT 1.0中局部变量无法在同级后续兄弟节点之后引用（除非在同一条指令内），这要求在组织模板内容时要注意变量定义的位置必须在使用点之前。
在条件与循环中使用变量的最佳实践
实际转换中，变量经常配合<xsl:if>、<xsl:choose>以及<xsl:for-each>使用。例如在遍历订单明细时，先把单价和数量算出金额存进变量，既能避免重复计算，也让表达式更清晰。由于XSLT变量不可变，在循环里每次迭代都会产生新的绑定，不会互相污染，这比命令式语言中的累加器更安全。
一个典型误用是试图在循环内用变量做累加求和，比如先定义$sum再在每次循环里让它加上当前值。在XSLT里这是做不到的，正确做法是用XPath的聚合函数sum()，或者在需分步处理时借助递归模板。下面示例展示如何用变量暂存单笔计算，再配合sum完成统计，既发挥变量可读性优势又符合语言模型。
<xsl:template match="orders">
<xsl:for-each select="order">
<xsl:variable name="amount" select="price * quantity"/>
<p>订单金额：<xsl:value-of select="$amount"/></p>
</xsl:for-each>
<p>总金额：<xsl:value-of select="sum(order/price * order/quantity)"/></p>
</xsl:template>
在条件判断里，变量还能提升表达式可读性。比如先把用户等级取出赋给$level，再在<xsl:choose>里比较，比反复写user/@level更不易出错。如果变量存的是节点集，还能继续用XPath对其过滤，例如$books[price > 100]，这种组合在生成报表时非常高效。掌握这些用法后，xsl:variable就从单纯的容器变成了组织XSLT逻辑的重要工具。
XSLTxsl:variableXML转换修改时间：2026-08-20 01:10:22