如何用Office.js将后端返回的字节数组转为Word桌面文档？

后端代码优化（C#） #

你的现有代码需要先把对比文档保存到服务器本地再读取字节数组，这不仅冗余还可能带来文件权限问题。直接在内存中处理对比后的文档，生成字节数组返回即可：

[HttpPost]
[Route("compare")]
public async Task<IActionResult> Compare(string original, string revised)
{
    Word.Application wordApp = new Word.Application();
    wordApp.Visible = false;
    object missing = Type.Missing;
    object readOnly = true;

    // 打开原始文档（只读模式避免锁定）
    Word.Document doc1 = wordApp.Documents.Open(
        original, 
        ReadOnly: readOnly,
        Visible: false
    );

    // 打开修订文档（只读模式）
    Word.Document doc2 = wordApp.Documents.Open(
        revised, 
        ReadOnly: readOnly,
        Visible: false
    );

    // 生成对比文档
    Word.Document compareDoc = wordApp.CompareDocuments(
        doc1, 
        doc2, 
        Word.WdCompareDestination.wdCompareDestinationNew,
        Word.WdGranularity.wdGranularityWordLevel,
        true, true, true, true, true, true, true, true, true, true, "", true
    );

    // 关闭原始文档，不保存
    doc1.Close(SaveChanges: Word.WdSaveOptions.wdDoNotSaveChanges);
    doc2.Close(SaveChanges: Word.WdSaveOptions.wdDoNotSaveChanges);

    // 内存中保存对比文档为字节数组
    byte[] byteArray;
    using (MemoryStream ms = new MemoryStream())
    {
        object format = Word.WdSaveFormat.wdFormatXMLDocument; // .docx格式
        compareDoc.SaveAs2(ms, format);
        byteArray = ms.ToArray();
    }

    // 关闭对比文档，退出Word
    compareDoc.Close(SaveChanges: Word.WdSaveOptions.wdDoNotSaveChanges);
    wordApp.Quit();

    // 返回字节数组，指定内容类型为docx
    return File(byteArray, "application/vnd.openxmlformats-officedocument.wordprocessingml.document");
}

关键改进点： #

• 用MemoryStream直接在内存中生成字节数组，跳过本地文件存储步骤
• 使用SaveAs2直接写入内存流，避免磁盘IO开销
• 返回FileResult而非普通对象，确保前端能正确识别文档类型
• 打开文档时设置ReadOnly: true，避免文件锁定问题

前端任务窗格代码（Office.js） #

前端拿到后端返回的字节数组后，需要用Office.js的API直接在桌面Word中打开文档，无需下载。以下是核心代码：

// 调用后端对比接口
async function compareDocuments(originalUrl, revisedUrl) {
    const response = await fetch('/api/compare', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
        },
        body: JSON.stringify({ original: originalUrl, revised: revisedUrl })
    });

    if (!response.ok) throw new Error('对比失败');

    // 获取字节数组
    const byteArray = await response.arrayBuffer();
    
    // 转成Base64字符串（Office.js需要）
    const base64 = btoa(String.fromCharCode(...new Uint8Array(byteArray)));

    // 在Word中打开对比文档
    await Word.run(async (context) => {
        // 创建文档对象
        const newDoc = context.application.createDocument(base64);
        await context.sync();
        
        // 打开文档
        newDoc.open();
        await context.sync();
    }).catch(err => {
        console.error('打开文档失败:', err);
        Office.context.ui.displayDialogAsync(`错误：${err.message}`);
    });
}

关键说明： #

• 使用fetch获取后端返回的字节数组，转成ArrayBuffer
• 将ArrayBuffer转成Base64字符串，这是Office.jscreateDocument方法要求的格式
• 通过Word.run执行批量操作，调用createDocument和open方法直接在桌面Word中打开对比文档

常见问题排查 #

• 确保后端返回的Content-Type是application/vnd.openxmlformats-officedocument.wordprocessingml.document，否则前端可能无法正确解析
• 桌面版Word需要支持Office.js的最新版本，确保任务窗格插件的运行环境符合要求
• 后端服务器需要有足够权限访问原始文档和修订文档的路径，避免文件无法打开的问题

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