XSLT的xsl:param怎么用 向样式表传递参数

xsl:param用于声明可外部传入的只读参数，提升XSLT复用性；需由处理器注入值，支持默认值，引用时XPath中须加$前缀，与xsl:variable本质不同。

xsl:param 用于在 XSLT 样式表中声明可外部传入的参数，让样式表更灵活、可复用。它本身不提供值，值需由调用方（如 XSLT 处理器、程序代码或命令行工具）传入；若未传值，可设默认值。

基本写法和默认值

在 XSLT 中任意顶层位置（如 内、模板外）声明：

这表示参数名为 lang，若调用时没给值，就用默认值 'zh'（字符串字面量）。也可以绑定到一个表达式，比如：

在模板中使用参数

声明后，参数名就可在 XPath 表达式中直接使用（不用加 $ 前缀）：

• 在匹配模板中：Hello（注意：这里必须加 $）
• 在属性值模板中：
• 作为函数参数：

⚠️ 注意：在 XPath 上下文中引用参数必须加 $（如 $lang），但在 select 属性里写默认值时不用（那是静态表达式，不是变量引用）。

从外部传入参数（常见方式）

参数值不能在 XSLT 文件里“自己设”，必须由处理器注入：

• Java（Transformer）：transformer.setParameter("lang", "en");
• Python（lxml）：transform(xslt_root, lang=etree.XSLT.strparam("en"))（字符串需用 strparam 包装）
• 命令行（xsltproc）：xsltproc --stringparam lang en style.xsl doc.xml（--stringparam 用于字符串，--param 用于 XPath 表达式）
• 浏览器（旧版支持）：不支持运行时传参，需预编译或改用 JS 控制

和 xsl:variable 的关键区别

别把 xsl:param 当成普通变量用：

• xsl:param 是只读的，且值来自外部；xsl:variable 是本地定义、不可重赋值，但值完全由样式表控制
• 同名 param 和 variable 共存时，param 优先级更高（会覆盖同名 variable）
• 全局 param 可被所有模板访问；局部 param（在模板内声明）仅限该模板作用域（XSLT 2.0+ 支持）

基本上就这些。用好 xsl:param 能让一个样式表适配多场景，比如切换语言、开关调试模式、动态过滤条件——不复杂但容易忽略。