xsl:message 是 XSLT 中用于输出调试信息的指令,不改变输出结果,支持纯文本、表达式值、条件触发及 terminate="yes" 中断处理,效果依赖处理器环境。

xsl:message 是 XSLT 中专门用于向处理器输出调试信息或诊断消息的指令,它不改变输出结果,只在处理过程中“打印”内容,非常适合排查模板匹配、变量值、上下文节点等问题。
基本用法:输出纯文本或表达式结果
直接写在模板中,执行时会将内容输出到控制台、日志或 IDE 的 XSLT 调试窗口(取决于你使用的处理器,如 Saxon、Xalan 或浏览器):
-
开始处理订单 —— 输出固定文本 -
当前 product ID: —— 插入属性值 -
计数: —— 输出计算结果
配合 xsl:if 实现有条件调试
避免满屏日志,只在关键分支或异常情况下触发:
这是第一个 item
使用 terminate="yes" 中断处理流程
当发现严重错误(比如必填字段为空、数据格式异常),可主动终止转换并提示原因:
错误:价格不能为空! - 加了 terminate="yes" 后,XSLT 处理器会立即停止,并把该消息作为错误抛出(类似 throw)
注意实际效果依赖处理器和运行环境
不同工具对 xsl:message 的支持略有差异:
- Saxon(命令行或 Java API)默认输出到 stderr,加 -t 参数可显示更详细日志
- 浏览器(如旧版 Firefox/IE)可能忽略或静默处理 xsl:message,不推荐用于前端调试
- Oxygen XML、XMLSpy 等编辑器能高亮捕获并展示所有 xsl:message 输出,体验最好
- 如果没看到输出,先确认是否启用了调试模式,或尝试加 terminate="yes" 强制暴露
基本上就这些。它不是花哨的功能,但用对了能省下大量翻日志、插断点的时间。










