求基于开源Java库将HTML转RTF的最优方案（Java Swing转换无效）

我完全理解你用Java Swing的JEditorPane转RTF时的糟心体验——它对复杂HTML（比如CSS样式、嵌套标签、列表表格）支持很差，经常丢样式、格式错乱，甚至连基本的文本排版都能出问题。下面推荐几个经过社区验证的开源库，能彻底解决这些痛点：

1. Apache POI HWPF + JSoup（灵活可控，适合自定义需求） #

Apache POI的HWPF模块专门用于处理RTF和Word 97-2003文档，结合JSoup解析HTML，可以完全自定义转换逻辑，适配各种复杂场景。

核心步骤与示例代码： #

import org.jsoup.Jsoup;
import org.jsoup.nodes.Document;
import org.jsoup.nodes.Element;
import org.apache.poi.hwpf.HWPFDocument;
import org.apache.poi.hwpf.usermodel.Range;
import java.io.FileOutputStream;

public class HtmlToRtfPoi {
    public static void main(String[] args) throws Exception {
        // 解析目标HTML内容
        String htmlContent = "<h1>核心标题</h1><p>这是一段<b>加粗</b>的文本，还有<i>斜体</i>和<u>下划线</u>样式。</p>";
        Document doc = Jsoup.parse(htmlContent);
        
        // 初始化RTF文档对象
        HWPFDocument rtfDoc = new HWPFDocument();
        Range range = rtfDoc.getRange();
        
        // 遍历HTML元素并转换为RTF格式
        for (Element element : doc.body().children()) {
            if (element.tagName().equals("h1")) {
                range.insertAfter(element.text() + "\n");
                // 设置标题样式：加粗+大字号
                range.getParagraphFormat().setBold(true);
                range.getCharacterFormat().setFontSize(16);
            } else if (element.tagName().equals("p")) {
                range.insertAfter(element.text() + "\n");
                // 处理子元素的样式（比如加粗、斜体）
                for (Element child : element.children()) {
                    int textLen = child.text().length();
                    Range styleRange = range.getCharacterRun(range.getEndOffset() - textLen - 1, range.getEndOffset() - 1);
                    if (child.tagName().equals("b")) styleRange.getCharacterFormat().setBold(true);
                    if (child.tagName().equals("i")) styleRange.getCharacterFormat().setItalic(true);
                }
            }
        }
        
        // 保存最终RTF文件
        try (FileOutputStream out = new FileOutputStream("output_poi.rtf")) {
            rtfDoc.write(out);
        }
    }
}

优点：完全可控，能处理复杂HTML结构和自定义样式；POI是Apache顶级项目，稳定性强。
缺点：需要自己编写部分转换逻辑，适合有定制需求的开发者。

2. Html2Rtf（轻量易用，开箱即用） #

这是一个专门做HTML到RTF转换的轻量开源库，封装了所有核心转换逻辑，不需要自己处理标签解析，适合快速开发场景。

用法示例： #

首先引入Maven依赖：

<dependency>
    <groupId>com.github.html2rtf</groupId>
    <artifactId>html2rtf</artifactId>
    <version>1.0.3</version>
</dependency>

核心代码：

import com.github.html2rtf.converter.Converter;
import com.github.html2rtf.converter.ConverterFactory;
import java.io.FileWriter;

public class HtmlToRtfSimple {
    public static void main(String[] args) throws Exception {
        String htmlContent = "<div><h2>二级标题</h2><ul><li>列表项1</li><li>列表项2</li></ul></div>";
        Converter converter = ConverterFactory.createConverter();
        // 一键转换HTML到RTF
        String rtfContent = converter.convert(htmlContent);
        
        // 写入文件
        try (FileWriter writer = new FileWriter("output_simple.rtf")) {
            writer.write(rtfContent);
        }
    }
}

优点：零配置，开箱即用；支持常见HTML标签（列表、表格、基本样式）；体积小，依赖少。
缺点：自定义样式的灵活性不如POI，对非常复杂的CSS支持有限。

3. XDocReport（支持模板驱动，适合批量转换） #

如果你需要结合模板或者批量处理HTML转RTF，XDocReport是个不错的选择——它支持将HTML内容填充到RTF模板中，也能直接转换纯HTML，对CSS样式的支持也更完善。

核心用法示例： #

import fr.opensagres.xdocreport.converter.ConverterTypeTo;
import fr.opensagres.xdocreport.converter.ConverterTypeVia;
import fr.opensagres.xdocreport.converter.IConverter;
import fr.opensagres.xdocreport.converter.Options;
import fr.opensagres.xdocreport.document.IXDocReport;
import fr.opensagres.xdocreport.document.registry.XDocReportRegistry;
import fr.opensagres.xdocreport.template.IContext;
import fr.opensagres.xdocreport.template.TemplateEngineKind;
import java.io.FileInputStream;
import java.io.FileOutputStream;

public class HtmlToRtfXDocReport {
    public static void main(String[] args) throws Exception {
        // 加载HTML模板（也可以直接用纯HTML作为模板）
        String htmlTemplate = "<html><body>${content}</body></html>";
        IXDocReport report = XDocReportRegistry.getRegistry().loadReport(new FileInputStream(htmlTemplate), TemplateEngineKind.Freemarker);
        
        // 设置上下文，传入需要转换的HTML内容
        IContext context = report.createContext();
        context.put("content", "<h3>XDocReport转换示例</h3><p>支持<u>下划线</u>和<span style='color:red'>红色文本</span></p>");
        
        // 配置转换选项：HTML转RTF
        Options options = Options.getTo(ConverterTypeTo.RTF).via(ConverterTypeVia.HTML);
        IConverter converter = report.getConverter(options);
        converter.convert(context, new FileOutputStream("output_template.rtf"));
    }
}

优点：支持模板和动态数据，适合批量生成RTF文档；对CSS样式支持较好。
缺点：依赖较多，学习成本略高。

选择建议 #

• 如果需求简单、想快速实现：选Html2Rtf
• 如果需要高度自定义、处理复杂HTML：选Apache POI + JSoup
• 如果需要模板驱动或批量转换：选XDocReport

这些方案都比Swing的JEditorPane靠谱得多，能有效解决样式丢失、格式错乱的问题。

内容的提问来源于stack exchange，提问作者hanumanth