使用DocumentFormat.OpenXML为Word段落应用标题样式失败的问题

我用C#的DocumentFormat.OpenXML编辑Word文档，想替换指定文本并给段落应用标题1样式。文本替换功能正常，但样式始终不生效——新文本显示正常，但还是普通文本格式，没变成标题样式，也没法用这个样式生成目录。我试过各种样式名称（"Header 1"、"Header1"、"header 1"、"header1"，甚至德语的"Überschrift 1"）都没用，我的代码如下：

int chapterNo = 1;
// Last step of opening the document
Body body = doc.MainDocumentPart.Document.Body;
// Iterate through all paragraphs containing a given text
foreach(Paragraph p in body.Descendants<Paragraph>().Where<Paragraph>(p => p.InnerText.Contains("**")))
{
    // Remove text and styles
    p.RemoveAllChildren<Run>();
    p.RemoveAllChildren<ParagraphProperties>();
    // Append new style to paragraph
    p.PrependChild<ParagraphProperties>(new ParagraphProperties(new ParagraphStyleId() { Val = "heading 1" }));
    // Add new text to paragraph
    p.AppendChild<Run>(new Run(new Text($"Chapter {chapterNo}")));
    chapterNo++;
}

问题出在样式ID的使用和段落属性的处理逻辑上，按以下方式修改即可解决：

1. 使用正确的内置样式内部ID
   Word内置标题样式有固定的内部标识符，标题1的正确ID是Heading1（无空格、首字母大写），而非界面显示的"标题 1"或其他语言版本名称。OpenXML仅识别这个内部ID，你之前尝试的名称都不符合要求。

2. 优化段落属性的处理方式
   不要直接删除所有ParagraphProperties后重建，优先复用已有属性再修改样式ID，避免意外清除其他必要属性。

修改后的代码如下：

int chapterNo = 1;
Body body = doc.MainDocumentPart.Document.Body;

foreach (Paragraph p in body.Descendants<Paragraph>().Where(p => p.InnerText.Contains("**")))
{
    // 清空段落原有文本内容
    p.RemoveAllChildren<Run>();
    
    // 获取已有段落属性，不存在则新建
    ParagraphProperties paraProps = p.Elements<ParagraphProperties>().FirstOrDefault();
    if (paraProps == null)
    {
        paraProps = new ParagraphProperties();
        p.PrependChild(paraProps);
    }
    
    // 移除旧样式设置，添加标题1样式
    paraProps.RemoveAllChildren<ParagraphStyleId>();
    paraProps.AppendChild(new ParagraphStyleId { Val = "Heading1" });
    
    // 添加新的标题文本
    p.AppendChild(new Run(new Text($"Chapter {chapterNo}")));
    chapterNo++;
}

3. 验证样式存在性
   如果是自定义模板或特殊文档，需确认文档中确实存在Heading1样式。可以用OpenXML SDK Tool打开文档，查看Styles节点下是否有StyleId为Heading1的样式定义，且该样式的类型为标题。

修改完成后，段落会正确应用内置标题1样式，既会显示标题的外观，也能被Word识别并用于生成目录。

内容的提问来源于stack exchange，提问作者kinda-wired