Office Word插件开发：点击图片ID跳转书签报错求助

你的代码存在几个关键问题，导致触发了GeneralException错误，以下是修正后的代码及问题说明：

修正后的代码 #

Office.context.document.addHandlerAsync(
  Office.EventType.DocumentSelectionChanged,
  async (result: any) => {
    // 缓存书签数据，避免每次事件触发重复读取localStorage
    const bookmarkStr = localStorage.getItem("bookmark");
    if (!bookmarkStr) return;
    
    const bookmarkParse = JSON.parse(bookmarkStr);
    console.log("bookmarkParse", bookmarkParse);

    try {
      await Word.run(async (context) => {
        const range = context.document.getSelection();
        // 先加载range的text属性，再执行同步
        context.load(range, "text");
        await context.sync();

        const selectedText = range.text.trim(); // 去除首尾空白，避免匹配失败
        console.log("选中的文本：", selectedText);

        // 快速定位匹配的书签项
        const matchedItem = bookmarkParse.find(item => item.ImageId === selectedText);
        if (matchedItem) {
          console.log("匹配到的书签：", matchedItem.bookmark);
          // 正确设置内部书签链接，格式为#书签名称
          range.hyperlink = `#${matchedItem.bookmark}`;
          await context.sync();
        } else {
          console.log("未匹配到对应的图片ID");
        }
      });
    } catch (error) {
      console.error("操作出错：", error);
    }
  }
);

关键问题修正说明 #

• 避免多上下文冲突：原代码在bookmarkParse.map循环中重复调用Word.run，会创建多个冲突的Word上下文，改成单次Word.run处理所有逻辑。
• 修复链接赋值语法错误：原代码的"#" + ${item.bookmark}是错误的模板字符串写法，正确格式为#${matchedItem.bookmark}`，直接生成Word内部书签的链接格式。
• 调整上下文加载顺序：必须先通过context.load(range, "text")指定要加载的属性，再执行context.sync()，才能正确获取选中区域的文本内容。
• 统一异步逻辑写法：原代码混合then和await导致异步逻辑混乱，改成全async/await写法，逻辑更清晰易维护。
• 增加异常捕获：添加try/catch捕获Word操作中的异常，便于快速定位问题。
• 优化匹配逻辑：用find替代map，找到匹配项后直接处理，无需遍历所有条目；添加trim()处理选中文本的空白，避免因空格导致匹配失败。

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