disable-output-escaping="yes"仅对xsl:value-of和xsl:text生效，须配合xsl:output method="html"使用，现代浏览器不支持，推荐用xsl:copy-of或结构化处理替代。

disable-output-escaping="yes" 是 XSLT 1.0 中控制输出是否转义特殊字符的关键属性，但它有明确的使用边界和常见陷阱，不能随意加就生效。

什么时候能用 disable-output-escaping="yes"

这个属性只对 <value-of></value-of> 和 <text></text> 生效，且仅在纯文本上下文中起作用

• ✅ 正确：<value-of select="html_snippet" disable-output-escaping="yes"></value-of>
• ✅ 正确：<text disable-output-escaping="yes"><div>Hello</div></text>
• ❌ 无效：<copy-of select="node()" disable-output-escaping="yes"></copy-of>（该属性对 copy-of 无意义）
• ❌ 无效：放在 <apply-templates></apply-templates> 或 <for-each></for-each> 上（语法错误）

必须配合 xsl:output method="html" 使用

如果输出目标是 HTML 页面，务必声明：

<xsl:output method="html" encoding="UTF-8" indent="yes"/>

否则即使设了 disable-output-escaping="yes"，处理器仍可能按 XML 规则转义 <code>> &。

浏览器兼容性要注意

• IE（老版本）和基于 Transformiix 的引擎（如旧版 Firefox）支持该属性
• 现代 Chrome、Safari、Edge（Chromium 内核）不支持 disable-output-escaping，会忽略它
• 如果必须兼容现代浏览器，推荐改用 <copy-of></copy-of> 替代（前提是源 XML 中存的是已解析的节点，不是字符串）

替代方案更可靠

当 disable-output-escaping 不可用或不稳定时：

ImageMagick 批处理处理器

使用 ImageMagick 的 convert 和 mogrify 命令进行批量图像处理，支持调整大小、裁剪、水印和格式转换。与 libvips 集成以实现高性能缩略图生成。

下载

• 用 <copy-of select="node()"></copy-of> 直接复制已构建好的元素树（要求数据本身是合法 XML 节点，不是字符串）
• 把 HTML 片段拆成结构化字段（比如 <title></title>, <p></p>, <ul></ul> 分别映射），再用标准 XSLT 元素生成
• 在数据层预处理：把含 HTML 的字段提前解析为 DOM 节点，再交给 XSLT 处理

实际例子：安全输出一段内联 HTML

假设 XML 中有：

<content><p>欢迎</p><strong>加粗内容</strong></content>

XSLT 正确写法：

<xsl:output method="html" encoding="UTF-8"/>
<xsl:template match="content">
  <xsl:value-of select="." disable-output-escaping="yes"/>
</xsl:template>

→ 渲染为真正的 <p>欢迎</p> <strong>加粗内容</strong>，而非文字。

不复杂但容易忽略。