如何使用OfficeJS保存当前工作簿内容并发送到自有文件系统

前置依赖说明 #

• 需在Excel加载项的Manifest配置文件中开放文件读取权限，否则调用API会抛出权限不足错误
• 仅支持Office 2016及以上版本、Office 365网页端/桌面端运行环境

核心实现逻辑 #

getFileAsync API可以获取当前打开工作簿的完整二进制流，支持按切片读取避免大文件加载卡顿，整体实现分为3步：

1. 调用API获取文件实例，指定切片大小（推荐设置为4MB，平衡传输效率和重试成本）
2. 循环读取所有切片，拼接为标准Blob格式的文件对象
3. 调用自有云存储的上传接口，将Blob上传到目标系统

完整实现代码如下：

// 第一个参数指定返回压缩格式的完整工作簿（对应xlsx/xlsm格式），第二个参数设置切片大小为4MB
Office.context.document.getFileAsync(Office.FileType.Compressed, { sliceSize: 4194304 }, function (result) {
    if (result.status === Office.AsyncResultStatus.Succeeded) {
        const file = result.value;
        const sliceCollection = [];
        let currentSliceIndex = 0;
        // 递归读取所有切片
        function loadSlice() {
            file.getSliceAsync(currentSliceIndex, function (sliceRes) {
                if (sliceRes.status === Office.AsyncResultStatus.Succeeded) {
                    sliceCollection.push(sliceRes.value.data);
                    currentSliceIndex++;
                    if (currentSliceIndex < file.sliceCount) {
                        loadSlice();
                    } else {
                        // 拼接为完整Blob对象
                        const fullWorkbook = new Blob(sliceCollection, {
                            type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
                        });
                        // 调用自有云上传逻辑
                        uploadToCloud(fullWorkbook);
                        // 释放文件资源，避免内存泄漏
                        file.closeAsync();
                    }
                } else {
                    console.error("切片读取失败：", sliceRes.error);
                    file.closeAsync();
                }
            })
        }
        loadSlice();
    } else {
        console.error("文件读取失败：", result.error);
    }
})

// 自有云上传方法示例，替换为实际业务的上传逻辑即可
function uploadToCloud(workbookBlob) {
    const formData = new FormData();
    formData.append("file", workbookBlob, `report_${Date.now()}.xlsx`);
    // 替换为自有云的上传接口地址
    fetch("/your-private-cloud/upload-api", {
        method: "POST",
        body: formData
    }).then(res => res.json())
    .then(res => {
        if (res.success) {
            // 上传成功后可执行后续的下载、后端处理、报表分发逻辑
            console.log("文件上传成功，存储ID：", res.fileId)
        } else {
            console.error("上传失败：", res.msg)
        }
    }).catch(err => {
        console.error("上传请求异常：", err)
    })
}

常见注意事项 #

• 权限配置：Manifest中必须添加<Permissions>ReadWriteDocument</Permissions>权限，否则API调用会被拦截
• 大文件优化：如果工作簿体积超过10MB，建议实现切片断点续传逻辑，某个分片上传失败时无需重新读取整个文件，仅重传失败分片即可
• 格式适配：Office.FileType.Compressed返回的是标准Office二进制格式，和手动保存到本地的文件内容完全一致，包含所有工作表、格式、公式、宏（宏启用工作簿也可正常读取）
• 内存清理：读取完成后必须调用file.closeAsync()释放占用内存，避免加载项长时间运行出现内存溢出问题

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