Office Word任务窗格加载项能否实现本地文件保存？

核心思路 #

Office JS没有直接操作本地文件的API（受浏览器安全限制），但可以先获取文档的二进制内容，再通过前端Blob+下载链接的方式触发浏览器的本地保存功能。

实现步骤 #

1. 获取Word文档的Base64内容 #

通过Word.run异步获取文档的分片Base64内容，拼接成完整的编码字符串：

async function getDocumentAsBase64() {
  return Word.run(async (context) => {
    const doc = context.document;
    return new Promise((resolve, reject) => {
      doc.getFileAsync(Word.FileFormat.docx, { sliceSize: 65536 }, (result) => {
        if (result.status !== Office.AsyncResultStatus.Succeeded) {
          reject(result.error);
          return;
        }

        const file = result.value;
        let fullBase64 = "";
        const fetchSlice = (index) => {
          file.getSliceAsync(index, (sliceResult) => {
            if (sliceResult.status !== Office.AsyncResultStatus.Succeeded) {
              file.closeAsync();
              reject(sliceResult.error);
              return;
            }

            fullBase64 += sliceResult.value.data;
            if (index === file.sliceCount - 1) {
              file.closeAsync();
              resolve(fullBase64);
            } else {
              fetchSlice(index + 1);
            }
          });
        };
        fetchSlice(0);
      });
    });
  });
}

2. 转换为Blob并触发本地下载 #

将Base64编码转换为Blob对象，通过创建临时<a>标签触发浏览器下载：

async function saveDocumentLocally() {
  try {
    const base64Content = await getDocumentAsBase64();
    // 解码Base64为二进制数组
    const byteChars = atob(base64Content);
    const byteArray = new Uint8Array(byteChars.length);
    for (let i = 0; i < byteChars.length; i++) {
      byteArray[i] = byteChars.charCodeAt(i);
    }

    // 创建Blob对象（对应docx格式的MIME类型）
    const blob = new Blob([byteArray], { 
      type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document" 
    });

    // 生成下载链接并触发点击
    const downloadUrl = URL.createObjectURL(blob);
    const link = document.createElement("a");
    link.href = downloadUrl;
    link.download = "local-saved-document.docx"; // 自定义文件名
    document.body.appendChild(link);
    link.click();

    // 清理临时资源
    setTimeout(() => {
      document.body.removeChild(link);
      URL.revokeObjectURL(downloadUrl);
    }, 100);
  } catch (err) {
    console.error("保存失败:", err);
    // 可在此添加用户友好的错误提示，比如弹出Office UI对话框
  }
}

3. 在Taskpane中绑定调用 #

给Taskpane页面的按钮添加点击事件，触发保存函数：

// 假设页面有id为save-local-btn的按钮
document.getElementById("save-local-btn").addEventListener("click", saveDocumentLocally);

关键注意点 #

• 依赖浏览器的下载权限，需确保用户允许浏览器弹出下载窗口
• 大文档通过分片获取避免内存占用过高，sliceSize可根据需求调整
• 如需保存为其他格式（如PDF），将Word.FileFormat.docx替换为Word.FileFormat.pdf，同时修改Blob的MIME类型为application/pdf

内容的提问来源于stack exchange，提问作者Adam Polak Moetsi