如何使用Office.JS为Excel单元格添加不可见的附加信息

方案可行性结论 #

你提到的基于Office Web Extension绑定的思路是官方原生支持的正确实现路径，<xm:f>中存储的单元格引用会自动跟随表格结构变动（插入/删除行列、移动单元格等）更新，不会出现地址关联失效的问题，完全可以满足你的需求。你之前调用addFromSelectionAsync未成功，大概率是执行时机或者参数配置问题，这个API就是实现该需求的官方标准接口。

核心实现代码（基于Office JS） #

1. 给选中单元格创建绑定并存储自定义信息 #

// 确保所有逻辑在Office初始化完成后执行
Office.onReady(() => {
  // 为当前选中的单元格/区域创建绑定
  Office.context.document.bindings.addFromSelectionAsync(
    Office.BindingType.Range,
    // 绑定ID加专属前缀，避免和其他加载项冲突
    { id: "MY_ADDON_BINDING_" + Date.now() },
    (result) => {
      if (result.status === Office.AsyncResultStatus.Succeeded) {
        const currentBinding = result.value;
        // 存储自定义不可见信息到绑定属性中
        currentBinding.settings.set("customMeta", "你需要存储的任意附加内容");
        // 持久化保存到文档
        currentBinding.settings.saveAsync((saveRes) => {
          if (saveRes.status === Office.AsyncResultStatus.Succeeded) {
            console.log("附加信息存储完成");
          }
        });
      } else {
        console.error("绑定创建失败：", result.error.message);
      }
    }
  );
});

2. 读取已存储的附加信息 #

// 通过绑定ID读取对应信息
Office.context.document.bindings.getByIdAsync("你的绑定ID", (result) => {
  if (result.status === Office.AsyncResultStatus.Succeeded) {
    const binding = result.value;
    // 读取自定义信息
    const meta = binding.settings.get("customMeta");
    // 获取当前绑定对应的最新单元格地址
    const currentAddress = binding.address;
    console.log("附加信息：", meta, "当前单元格地址：", currentAddress);
  }
});

3. 批量获取所有自定义绑定 #

Office.context.document.bindings.getAllAsync((result) => {
  if (result.status === Office.AsyncResultStatus.Succeeded) {
    // 筛选属于你的加载项的绑定
    const myBindings = result.value.filter(item => item.id.startsWith("MY_ADDON_BINDING_"));
    myBindings.forEach(binding => {
      console.log("绑定ID：", binding.id, "单元格地址：", binding.address, "附加信息：", binding.settings.get("customMeta"));
    });
  }
});

原理说明 #

你在保存后的Excel文件中看到的XML内容就是上述API自动生成的：

• <xm:f>标签存储绑定对应的区域引用，Excel内核会自动跟踪该区域的位置变化，无需手动维护地址关联
• 你存入binding.settings的自定义信息会保存在<we:properties>标签中，和绑定ID一一对应，对普通用户不可见，会跟随Excel文件持久化保存
• 绑定和自定义信息都不会影响单元格本身的内容和用户的正常操作

注意事项 #

• 所有绑定相关操作必须放在Office.onReady()回调中执行，否则会出现调用失败的问题
• 如果需要删除绑定和对应的附加信息，调用binding.deleteAsync()即可，不会影响单元格原有内容
• 如果需要给多个非连续单元格分别附加信息，遍历选中区域的每个单元格单独调用addFromRangeAsync创建绑定即可

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