docx文件中方括号内文本渲染异常问题求助（docx4j）

问题背景 #

使用MS Word的「审阅->翻译文档」将docx文件译为阿拉伯语后，部分不应翻译的方括号内文本（如[SM type="Y" full="hpcon"/]）被误译，于是用docx4j编写Java代码从原文档提取该部分内容替换到译后文档。替换后document.xml中的内容与原文档一致，但docx渲染时方括号后出现引号加斜杠的顺序错乱（如显示为تشغيل [/"SM type="Y" full="hpcon]），调整对齐方式无效。

原因分析 #

1. 双向文本排版冲突：阿拉伯语是从右到左（RTL）的双向语言，Word的双向文本排版算法会自动调整文本顺序。你替换的方括号内容属于从左到右（LTR）的文本片段，混合RTL和LTR文本时，算法错误解析了引号、斜杠这类符号的排版顺序，导致显示错乱。
2. 缺少方向控制属性：docx4j替换文本时，未给LTR的方括号内容设置正确的双向文本控制标记，Word无法识别这部分内容需要保持LTR排版方向，进而与周围的RTL翻译文本产生排版冲突。

解决方法 #

方法1：通过docx4j设置Run的LTR方向属性 #

在替换方括号内容的Run时，明确设置其排版方向为LTR，添加对应的样式属性：

// 获取目标Run的样式属性对象
RPr rPr = targetRun.getRPr();
if (rPr == null) {
    rPr = new RPr();
    targetRun.setRPr(rPr);
}
// 禁用RTL方向，强制LTR
BooleanDefaultTrue rtlFlag = new BooleanDefaultTrue();
rtlFlag.setVal(false);
rPr.setRtl(rtlFlag);
// 设置双向文本控制，确保按LTR顺序渲染
Bidi bidiControl = new Bidi();
bidiControl.setVal(false);
rPr.setBidi(bidiControl);

方法2：插入双向控制字符 #

在方括号内容的前后分别插入双向控制字符，强制Word识别其LTR排版方向：

• 方括号内容前插入\u200E（左到右标记，LTRM）
• 方括号内容后插入\u200F（右到左标记，RTLM）

示例替换文本：

String originalTag = "[SM type=\"Y\" full=\"hpcon\"]";
String formattedTag = "\u200E" + originalTag + "\u200F";
// 用formattedTag替换译后文档中的对应内容

方法3：验证并修复document.xml结构 #

检查译后文档的document.xml，确保包含方括号内容的w:r节点有独立的w:rPr属性，且未继承周围RTL文本的方向属性，避免样式冲突。

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