如何为docx4j生成的footnoteReference Run设置正确样式？

我明白你遇到的问题——当你添加脚注引用时，它继承了前一个Run的格式（比如你示例里的darkCyan高亮），而且没有自动应用FootnoteReference样式，导致脚注引用没有显示为上标。这是因为docx4j不会自动为脚注引用的Run创建独立的格式属性，默认会复用上下文的Run属性（rPr）。

要解决这个问题，你需要为脚注引用创建一个独立的Run，并显式配置它的样式和格式，具体步骤如下：

1. 创建全新的Run对象 #

不要在已有Run中添加脚注引用，而是新建一个Run来单独承载它，这样就能彻底避免继承前一个Run的rPr。

2. 配置Run的属性（RPr） #

• 显式应用FootnoteReference样式，这个样式是Word默认自带的，包含上标等脚注引用需要的格式。
• 可以额外手动设置上标属性作为兜底，确保样式未生效时也能正确显示。

完整代码示例 #

// 获取docx4j的WML工厂对象
ObjectFactory wmlObjectFactory = Context.getWmlObjectFactory();

// 1. 创建一个全新的Run，用于承载脚注引用
Run footnoteRefRun = wmlObjectFactory.createRun();

// 2. 创建并配置Run的属性RPr
RPr rPr = wmlObjectFactory.createRPr();

// 2.1 应用FootnoteReference样式
StyleDefinitionsPart stylePart = wordprocessingMLPackage.getMainDocumentPart().getStyleDefinitionsPart();
Style footnoteStyle = stylePart.getStyle("FootnoteReference");
if (footnoteStyle != null) {
    RStyle rStyle = wmlObjectFactory.createRStyle();
    rStyle.setVal(footnoteStyle.getStyleId());
    rPr.setRStyle(rStyle);
}

// 2.2 手动设置上标作为兜底（可选，但能确保显示效果）
VerticalAlign vertAlign = wmlObjectFactory.createVerticalAlign();
vertAlign.setVal(VerticalAlignRun.SUPERSCRIPT);
rPr.setVertAlign(vertAlign);

// 将配置好的RPr绑定到Run
footnoteRefRun.setRPr(rPr);

// 3. 创建脚注引用并添加到新Run中
CTFtnEdnRef ftnednref = wmlObjectFactory.createCTFtnEdnRef();
JAXBElement<CTFtnEdnRef> ftnednrefWrapped = wmlObjectFactory.createRFootnoteReference(ftnednref);
footnoteRefRun.getContent().add(ftnednrefWrapped);
ftnednref.setId(BigInteger.valueOf(i)); // i为你的脚注ID

// 4. 将这个新Run添加到目标段落中
Paragraph targetPara = ...; // 替换为你要添加脚注引用的段落
targetPara.getContent().add(footnoteRefRun);

效果说明 #

执行这段代码后，生成的XML会是这样的独立Run，不会复用之前的格式：

<w:r>
  <w:rPr>
    <w:rStyle w:val="FootnoteReference"/>
    <w:vertAlign w:val="superscript"/>
  </w:rPr>
  <w:footnoteReference w:id="2"/>
</w:r>

这样脚注引用就会正确应用FootnoteReference样式，显示为上标，且不会继承前一个Run的格式。

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