如何查找Word Add-in中通过OOXML插入的内容并替换

我帮你分析下你遇到的问题，然后给出几个可行的解决方案：

问题根源分析 #

先看你插入的OOXML代码，这里有两个关键问题导致你之前的查找失败：

1. 你用<w:alias w:val="mytag"/>设置的是内容控件的别名（Alias），但getByTitle()方法对应的是OOXML里的<w:title>标签，不是<w:alias>，所以通过标题查找自然找不到。
2. 你设置的<w:tag w:val="469"/>是正确的标签，但之前的查找代码可能因为同步时机或者加载方式的问题没拿到结果；另外你用搜索文本的方法时，SearchOptions里重复设置了matchWildCards一会true一会false，导致搜索规则混乱，才出现了拆分字符的奇怪结果。

可行解决方案 #

方案1：修正OOXML，让getByTitle/getByTag能正常工作 #

如果你想继续用getByTitle或getByTag，可以先调整插入的OOXML，把<w:alias>改成<w:title>（或者同时保留），这样getByTitle就能识别：

<!-- 修改后的OOXML片段 -->
<w:sdtPr>
  <w:tag w:val="469"/>
  <w:text />
  <w:title w:val="mytag" /> <!-- 这里把alias改成title，或者添加title标签 -->
</w:sdtPr>

然后用正确的查找代码，注意要确保加载所有必要的属性，并且同步顺序正确：

// 通过标题查找的修正代码
Word.run(async (context) => {
  let ccCollection = context.document.contentControls.getByTitle("mytag");
  await ccCollection.load("items");
  await context.sync();
  
  if (ccCollection.items.length > 0) {
    let targetCC = ccCollection.items[0];
    // 替换内容控件的文本
    targetCC.insertText("REPLACED", Word.InsertLocation.replace);
    await context.sync();
    console.log("内容已替换");
  } else {
    console.log("未找到对应内容控件");
  }
});

如果用标签查找，代码类似，只需要把getByTitle换成getByTag("469")即可。

方案2：正确使用文本搜索替换 #

之前的搜索选项设置混乱，导致搜索结果异常。我们清理SearchOptions，精准匹配[_MyText]：

Word.run(async (context) => {
  let options = Word.SearchOptions.newObject(context);
  options.matchWildCards = false; // 关闭通配符，精准匹配
  options.matchCase = false; // 忽略大小写，根据需要调整
  
  let rangesFind = context.document.body.search('[_MyText]', options);
  await rangesFind.load("items");
  await context.sync();
  
  if (rangesFind.items.length > 0) {
    rangesFind.items.forEach(item => {
      // 替换文本，或者插入OOXML
      item.insertText("REPLACED", Word.InsertLocation.replace);
      // 如果要插入OOXML，用item.insertOoxml(yourOoxml, Word.InsertLocation.replace);
    });
    await context.sync();
    console.log("文本替换完成");
  } else {
    console.log("未找到目标文本");
  }
});

方案3：遍历所有内容控件筛选匹配项 #

如果不想修改OOXML，可以遍历文档中所有内容控件，通过tag或alias属性来筛选：

Word.run(async (context) => {
  let allCCs = context.document.contentControls;
  await allCCs.load("items, tag, alias"); // 加载需要的属性
  await context.sync();
  
  // 筛选tag为469或者alias为mytag的内容控件
  let targetCC = allCCs.items.find(cc => cc.tag === "469" || cc.alias === "mytag");
  
  if (targetCC) {
    // 替换内容，这里直接替换内容控件的文本
    targetCC.insertText("REPLACED", Word.InsertLocation.replace);
    // 或者替换成OOXML：targetCC.insertOoxml(yourOoxml, Word.InsertLocation.replace);
    await context.sync();
    console.log("内容控件已替换");
  } else {
    console.log("未找到目标内容控件");
  }
});

额外提示 #

• 操作Word对象模型时，尽量用async/await替代then链式调用，代码更易读且不易出错。
• 每次修改后一定要调用context.sync()来同步本地和文档的状态。

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