如何为Apache POI 3.17的XWPFParagraph设置悬挂缩进？

我之前在处理Word文档格式的时候，也踩过POI 3.17设置悬挂缩进的坑——明明调用了setIndentationHanging()却看不到预期效果，后来才发现是几个细节没注意到，给你整理几个可行的解决方案：

• 注意缩进单位转换：POI里的缩进参数单位是twip（缇），不是我们常用的厘米或英寸！1英寸=1440缇，1厘米≈567缇。如果直接传个小数字（比如2），实际缩进几乎看不见。比如要设置0.5英寸的悬挂缩进，应该传720：

  XWPFParagraph paragraph = ...; // 你的段落对象
  // 设置0.5英寸的悬挂缩进
  paragraph.setIndentationHanging(720);
  

• 清除首行缩进的干扰：Word段落默认可能带有首行缩进设置，这会和悬挂缩进规则冲突。建议同时把首行缩进设为0：

  paragraph.setIndentationFirstLine(0); // 清除首行缩进
  paragraph.setIndentationHanging(720); // 设置悬挂缩进
  

• 检查段落样式的覆盖：如果你的段落应用了预设样式（比如"正文"样式），样式里的缩进规则会优先于你手动设置的参数。可以先移除样式再设置格式：

  paragraph.setStyle(""); // 清空现有样式
  paragraph.setIndentationFirstLine(0);
  paragraph.setIndentationHanging(720);
  

• 直接操作底层XML（终极方案）：如果上面的方法都不行，可能是POI 3.17的API封装有遗漏，直接操作CTPPr（段落的底层XML对象）更可靠：

  XWPFParagraph paragraph = ...;
  CTPPr pPr = paragraph.getCTP().getPPr();
  if (pPr == null) {
      pPr = paragraph.getCTP().addNewPPr();
  }
  CTInd ind = pPr.getInd();
  if (ind == null) {
      ind = pPr.addNewInd();
  }
  // 设置悬挂缩进720缇，首行缩进0
  ind.setHanging(BigInteger.valueOf(720));
  ind.setFirstLine(BigInteger.valueOf(0));
  

试完这些方法应该就能看到正确的悬挂缩进效果了，记得在段落内容写入完成后再设置格式，避免后续操作覆盖你的设置~

内容的提问来源于stack exchange，提问作者Mohammed Ibrahim K. Bokhari