JEditorPaneHTMLEditorKitParserUnescape取消转义

wen java案例 2026-07-25 1

本文目录导读：

手动替换回转义序列（最简单）
使用<pre>标签包裹（部分有效）
禁用 HTMLEditorKit 的默认解析器（复杂）
使用其他渲染方式（推荐替代方案）
总结建议

在Java的JEditorPane配合HTMLEditorKit解析HTML时，默认的解析器会自动对HTML实体（如&、<、>、"等）进行取消转义（unescape），即将转义后的字符还原为原始字符（如&、、`>等）。

如果你想要阻止这种行为，即保留HTML实体不被转换，通常没有一个直接的API开关可以关闭HTMLEditorKit内部的实体解析逻辑，但有几种常用的变通方案：

手动替换回转义序列（最简单）

在将HTML内容设置到JEditorPane之前，先将原始内容中的特殊字符手动替换为HTML实体，这样解析器再次转义后，看起来就跟原始内容一致。

String original = "这是 &amp; 符号";  // 实际上你想要显示 &amp; 这个文本
// 先手动将 & 替换为 &amp;，再设置到编辑器
String escaped = original.replace("&", "&amp;");  // 变成 这是 &amp;amp; 符号
// 设置到 JEditorPane，解析器会解析成：这是 &amp; 符号
editorPane.setText(escaped);

使用`<pre>`标签包裹（部分有效）

将需要保留原始内容的部分放在<pre>标签内，HTMLEditorKit对<pre>内的文本一般不会做实体解析，但对于一些特殊字符仍可能被解析。

String html = "<pre>&amp; &lt; &gt;</pre>";
editorPane.setText(html);

优点：简单
缺点：会改变字体，且表格、列表等复杂结构内不适用

禁用 `HTMLEditorKit` 的默认解析器（复杂）

通过自定义 HTMLEditorKit 并覆盖 getParser() 方法，返回一个不解析实体的解析器，这是最彻底的方案，但实现较复杂。

import javax.swing.text.html.*;
import javax.swing.text.html.parser.*;
public class CustomHTMLEditorKit extends HTMLEditorKit {
    @Override
    public HTMLEditorKit.Parser getParser() {
        return new ParserDelegator() {
            @Override
            public void parse(Reader r, HTMLEditorKit.ParserCallback cb, boolean ignoreCharSet) throws IOException {
                // 使用自定义的 DTD 或解析器，跳过实体翻译
                super.parse(r, new ParserCallback() {
                    @Override
                    public void handleText(char[] data, int pos) {
                        // 不进行任何转义，直接传递原始字符数组
                        cb.handleText(data, pos);
                    }
                    // 其他方法代理...
                }, ignoreCharSet);
            }
        };
    }
}

问题：ParserDelegator内部仍会调用默认的实体映射，覆盖并不容易，需要深度修改源码。

使用其他渲染方式（推荐替代方案）

如果JEditorPane的实体解析行为无法满足需求，可以考虑使用更现代的组件：

方案	说明
JavaFX `WebView`	完整的WebKit引擎，可通过在HTML中包裹`<xmp>`或手动处理
Swing `JTextPane` + 自定义View	手动解析HTML子集，控制实体处理
Flyingsaucer (XHTML renderer)	完全可控的CSS+XML渲染，实体可配置
自己解析HTML，用`JTextPane`展示纯文本	手动控制实体转义逻辑

总结建议

如果只是偶尔需要：使用方案1（手动双重转义），简单有效。
如果整段HTML都需保留实体：先用&替换所有&。
如果项目允许更换组件：推荐使用JavaFX WebView，对HTML实体的控制更灵活。

// 通用工具方法：保留所有实体文本
public static String preserveEntities(String html) {
    return html.replace("&", "&amp;");
    // 注意：这会将 &lt; 变成 &amp;lt; 显示为 &lt;
}

如需进一步帮助,请提供你的具体使用场景（如只是显示代码片段中的实体，还是需要保留XML标签结构）。