如何用docx4j更新含MS Word文档信息域的Sdt Content内容？

一、正确修改含Document Info域的SDT内容的方法 #

绑定到Word“Document Info”域的SDT属于数据绑定型SDT，其内容并非直接存储在<w:sdtContent>的<w:t>元素中，而是关联到文档的核心属性或自定义属性。直接修改<w:sdtContent>的文本不会触发同步更新，正确做法是修改对应的数据源属性：

1. 修改文档核心属性（针对内置Document Info字段，如标题、作者）
   使用docx4j获取并修改文档的核心属性，绑定的SDT会自动同步更新：

   // 加载文档
   WordprocessingMLPackage wordMLPackage = WordprocessingMLPackage.load(new File("your-template.docx"));
   // 获取核心属性
   CoreProperties coreProps = wordMLPackage.getPackageProperties().getCoreProperties();
   // 修改标题（对应Document Info里的标题域）
   coreProps.setTitle("新的文档标题");
   // 保存文档
   wordMLPackage.save(new File("updated-document.docx"));
   

2. 修改自定义属性（针对自定义Document Info字段）
   如果是自定义的Document Info字段，需要操作文档的自定义属性部件：

   CustomProperties customProps = wordMLPackage.getCustomProperties();
   // 假设自定义属性名为"CustomTitle"
   CustomProperty prop = customProps.getProperty("CustomTitle");
   if (prop != null) {
       prop.setStringValue("新的自定义标题");
   } else {
       // 若属性不存在，创建新属性
       prop = new CustomProperty();
       prop.setName("CustomTitle");
       prop.setStringValue("新的自定义标题");
       customProps.addProperty(prop);
   }
   wordMLPackage.save(new File("updated-document.docx"));
   

3. 强制刷新SDT内容（可选，若修改数据源后仍未更新）
   若修改属性后SDT未自动刷新，可手动触发SDT内容更新：

   // 遍历所有SDT
   List<SdtBlock> sdtBlocks = wordMLPackage.getMainDocumentPart().getJAXBNodesViaXPath("//w:sdt", false);
   for (SdtBlock sdt : sdtBlocks) {
       // 获取SDT的数据绑定信息
       DataBinding dataBinding = sdt.getSdtPr().getDataBinding();
       if (dataBinding != null) {
           // 根据绑定路径重新获取属性值并更新sdtContent
           String newValue = coreProps.getTitle();
           // 清空原有内容并添加新文本
           sdt.getSdtContent().getContent().clear();
           Text text = new Text();
           text.setValue(newValue);
           Run run = new Run();
           run.getContent().add(text);
           Paragraph para = new Paragraph();
           para.getContent().add(run);
           sdt.getSdtContent().getContent().add(para);
       }
   }
   

二、页眉与首页标题域的关联机制 #

页眉和首页的标题SDT之所以能保持值一致，是因为它们绑定到同一个文档属性数据源：

• 在Word文档的XML结构中，这类SDT的<w:sdtPr>节点下会包含<w:dataBinding>元素，其中的w:xpath属性指向同一个属性路径（比如核心属性的/cp:coreProperties/dc:title，或自定义XML部件的特定节点路径）。
• 当文档属性值发生变化时，Word会自动遍历所有绑定该路径的SDT，同步更新它们的<w:sdtContent>内容，从而实现多位置内容的一致性。
• 这种关联是Word的内置数据绑定机制，无需手动维护多个SDT的内容，只需修改统一的数据源即可。

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