Apache POI加载模板标题样式在Microsoft Word中失效求助

问题原因 #

Microsoft Word的文档渲染逻辑和LibreOffice不同：当模板中的样式没有被实际段落引用时，Word打开文档会自动清理未被使用的样式定义。这就导致你通过代码设置的样式名称找不到对应的格式规则，最终显示为普通文本；而LibreOffice会保留所有模板中的样式定义，所以能正常识别。

解决方案 #

不需要自定义带编号的样式，只需让Word认为模板中的标题样式已被使用，就能保留样式定义。推荐用临时隐藏占位段落的方法，步骤如下：

1. 加载模板时检查并创建临时占位段 #

如果模板里没有已使用目标样式的段落，就创建一个隐藏的占位段落（必须包含内容，否则Word仍会忽略），让Word识别到该样式被引用：

val document = XWPFDocument(template.inputStream)

// 检查模板中是否已有使用"Heading 1"的段落
val hasUsedHeading1 = document.paragraphs.any { it.style == "Heading 1" }
var placeholderPar: XWPFParagraph? = null

if (!hasUsedHeading1) {
    // 创建临时占位段落
    placeholderPar = document.createParagraph()
    placeholderPar.style = "Heading 1"
    // 设置段落为隐藏，避免影响最终文档
    val run = placeholderPar.createRun()
    run.text = " " // 必须有文本内容
    run.fontSize = 1
    run.isHidden = true // 隐藏文本
}

2. 创建目标段落并应用样式 #

正常创建需要的段落并设置样式：

// 创建目标段落并应用Heading 1样式
val targetPar = document.createParagraph()
targetPar.style = "Heading 1"
val targetRun = targetPar.createRun()
targetRun.text = "这是你的标题内容"

3. 删除临时占位段落 #

处理完所有内容后，删除之前创建的占位段落：

// 移除临时占位段（如果创建了的话）
placeholderPar?.let {
    val index = document.paragraphs.indexOf(it)
    if (index != -1) {
        document.removeBodyElement(index)
    }
}

效果说明 #

• 执行上述代码后，Microsoft Word打开文档时，会保留模板中"Heading 1"的样式定义，目标段落会正常显示带编号的标题格式
• LibreOffice的正常识别不受影响

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