使用docx4j生成RTL文档：Word2019不兼容问题求助

针对你遇到的docx4j生成含阿拉伯语+英语的RTL文档在Word 2019中失效，但Word 2013正常的问题，可以尝试以下几种解决方案：

1. 升级docx4j到最新稳定版 #

旧版本的docx4j对Word 2019的OOXML规范支持不足，建议升级到最新的docx4j-core版本（例如11.4.11），新版本会修复高版本Word的兼容性问题，尤其是RTL方向的属性映射。

2. 显式设置段落和字符的RTL属性 #

不要依赖XHTML自动转换的RTL设置，手动为段落和文本块添加Word 2019识别的BiDi属性：

// 创建段落并配置RTL方向
P paragraph = new P();
PPr paragraphPr = new PPr();

// 设置段落文本方向为RTL
TextDirection textDir = new TextDirection();
textDir.setVal(STTextDirection.RL);
paragraphPr.setTextDirection(textDir);

// 启用段落双向布局
BiDi paraBidi = new BiDi();
paraBidi.setVal(true);
paragraphPr.setBiDi(paraBidi);

paragraph.setPPr(paragraphPr);

// 添加阿拉伯语文本块
R arabicRun = new R();
Text arabicText = new Text();
arabicText.setValue("مثال نص عربي");

RPr arabicRunPr = new RPr();
BiDi runBidi = new BiDi();
runBidi.setVal(true);
arabicRunPr.setBiDi(runBidi);
arabicRun.setRPr(arabicRunPr);
arabicRun.getContent().add(arabicText);
paragraph.getContent().add(arabicRun);

// 添加英语文本块（无需RTL设置，Word会自动适配双向文本）
R englishRun = new R();
Text englishText = new Text();
englishText.setValue(" English example text");
englishRun.getContent().add(englishText);
paragraph.getContent().add(englishRun);

// 将段落添加到文档
wordprocessingMLPackage.getMainDocumentPart().getContent().add(paragraph);

3. 配置文档级别的RTL默认设置 #

在文档设置中全局启用双向布局，确保Word 2019识别文档的RTL属性：

Settings docSettings = new Settings();
// 设置文档双向布局启用
BiDi docBidi = new BiDi();
docBidi.setVal(true);
docSettings.setBiDi(docBidi);

// 添加默认制表位（可选，保证RTL布局的格式一致性）
DefaultTabStop defaultTab = new DefaultTabStop();
defaultTab.setVal(BigInteger.valueOf(720));
docSettings.setDefaultTabStop(defaultTab);

wordprocessingMLPackage.getMainDocumentPart().addObject(docSettings);

4. 优化XHTML导入配置 #

如果是通过XHTML导入生成文档，确保XHTMLImporter正确识别dir="rtl"属性，并完整保留格式：

XHTMLImporterImpl importer = new XHTMLImporterImpl(wordprocessingMLPackage);
// 不忽略任何段落和字符格式
importer.setParagraphFormatting(FormattingOption.IGNORE_NONE);
importer.setRunFormatting(FormattingOption.IGNORE_NONE);
// 显式声明HTML命名空间，确保dir属性被正确解析
importer.getConversionContext().getNamespaceContext().put("html", "http://www.w3.org/1999/xhtml");

// 导入XHTML内容
List<Object> docContent = importer.convert(xhtmlContent, null);
wordprocessingMLPackage.getMainDocumentPart().getContent().addAll(docContent);

问题原因说明 #

Word 2019对OOXML的RTL属性验证更严格，旧版docx4j生成的RTL标记仅符合Word 2013及更早版本的规范，缺少Word 2019要求的显式段落/字符级BiDi属性，导致RTL方向不生效。通过显式设置这些属性或升级docx4j版本，可以解决兼容性问题。

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