xsl:message 是 XSLT 唯一原生轻量调试手段，需用 terminate="yes" 强制输出、配合 Oxygen/Saxon 等工具查看，且仅限开发阶段使用。
怎么用 xsl:message 打印调试信息
xsl:message 是 XSLT 里唯一原生、轻量、不改变输出的调试手段——它只“说话”，不“做事”。只要处理器支持（Saxon、Xalan、Visual Studio、Oxygen 都行），你就能立刻看到上下文里的变量值、节点名、计数结果。
- 纯文本输出：
<xsl:message>开始处理订单</xsl:message> - 插入表达式：
<xsl:message>当前 product ID: <xsl:value-of select="@id"/></xsl:message> - 嵌套任意模板内容，比如
<xsl:for-each>或<xsl:if>，但注意：它不生成结果树，只输出调试流 -
浏览器（如新版 Chrome/Firefox）通常**静默忽略**
xsl:message，别指望在前端看到输出；调试务必换本地工具
为什么加 terminate="yes" 才能看到消息
很多新手写完 <xsl:message>debug</xsl:message> 却没任何输出，不是代码错了，而是处理器把消息当“日志”发到 stderr 或后台，而你的终端/IDE 没显示或被过滤了。加 terminate="yes" 是最可靠的“强制曝光”方式——它让处理器立刻中断，并把消息作为错误抛出，自然就弹出来了。
-
<xsl:message terminate="yes"><xsl:value-of select="count(//item)" /> 个 item</xsl:message>→ 立即报错并显示数字，方便确认 XPath 是否命中 - 仅用于开发阶段，上线前必须删掉或改成
terminate="no"，否则转换永远失败 - Saxon 命令行下加
-t参数可同时看到所有terminate="no"消息，但默认不显示
配合 <xsl:if> 和上下文做精准断点
XSLT 没有传统断点，但你可以用 <xsl:if> + <xsl:message> 模拟“条件断点”：只在特定节点、特定属性值、空节点等异常场景触发输出，避免日志刷屏。
- 检查必填字段是否为空：
<xsl:if test="not(@ref) or @ref = ''"><xsl:message terminate="yes">警告：@ref 缺失！</xsl:message></xsl:if> - 确认模板是否被正确匹配：
<xsl:template match="order"><xsl:message>✅ 进入 order 模板，name()=<xsl:value-of select="name()"/></xsl:message>...</xsl:template> - 注意：
<xsl:message>的 XPath 表达式始终相对于**当前上下文节点**，不是全局根节点
哪些工具真能看见 xsl:message 输出
不是所有环境都平等对待 xsl:message。选错工具，等于写了白写。
-
Oxygen XML Editor：顶部 “Messages” 视图自动捕获并高亮所有
xsl:message，支持点击跳转到源码行，体验最佳 -
Saxon（命令行）：默认输出到
stderr，加saxon -xsl:style.xsl -s:input.xml -t可见详细日志；加terminate="yes"则直接报错中断 -
Visual Studio（Professional/Enterprise）：启用
XslCompiledTransform(true)后，F5 调试时可在“输出”窗口看到xsl:message，且支持设断点+逐行执行 -
浏览器（Chrome/Firefox）：基本无视
xsl:message，即使加了terminate="yes"也常静默失败，不要依赖
真正卡住人的从来不是语法，而是：以为消息没输出是代码错了，其实是工具没选对，或者没加 terminate="yes" 强制暴露。先在 Oxygen 或 Saxon 命令行跑通一条 <xsl:message terminate="yes">test</xsl:message>，再往下写——这一步省掉，后面全在盲调。
