使用JavaScript API开发Word插件时导入外部DOCX的文本格式丢失问题

我正在用JavaScript API开发Microsoft Word插件，尝试导入外部DOCX文件到当前文档时遇到格式丢失问题：

• 将DOCX转成Base64后，用以下代码导入：

const openExternalDocument = async () => {
    await Word.run(async (context) => {
        console.log("Opening external document...");
        // 使用选中.docx文件的Base64编码字符串
        const externalDoc = context.application.createDocument(getDocumentAsBase64());
        await context.sync();

        const externalDocBody = externalDoc.body;
        externalDocBody.load("text");
        await context.sync();

        // 将外部文档文本插入到当前文档开头
        const externalDocBodyText = externalDocBody.text;
        const currentDocBody = context.document.body;
        currentDocBody.insertText(externalDocBodyText, Word.InsertLocation.start);
        await context.sync();
    }).catch(function (myError) {
        console.log("Error", myError);
    });
};

• 导入成功，但原文档中的公式等带格式的特殊内容无法正常显示：
  原文档：
  
  导入后文档：
  

当前代码只提取了文档的纯文本内容（externalDocBody.text），纯文本本身不包含任何格式信息、公式对象或富文本结构，自然会丢失原文档的格式和特殊内容。load("text")只会加载无格式的文本数据，公式这类对象不会被转换成可识别的文本，只会变成占位符或乱码。

要保留格式和特殊内容，需要直接导入外部文档的完整内容结构，而不是提取纯文本。可以通过insertFileFromBase64方法直接插入Base64格式的DOCX文件，这个方法会完整保留原文档的所有格式和对象：

修改后的代码如下：

const openExternalDocument = async () => {
    await Word.run(async (context) => {
        console.log("Opening external document...");
        const base64Doc = getDocumentAsBase64();
        // 直接将Base64格式的DOCX插入到当前文档开头，保留完整格式
        context.document.body.insertFileFromBase64(base64Doc, Word.InsertLocation.start);
        await context.sync();
    }).catch(function (myError) {
        console.log("Error", myError);
    });
};

关键说明 #

• insertFileFromBase64是Word JS API专门用于导入完整DOCX内容的方法，它会解析Base64中的DOCX包，将所有元素（格式、公式、图片、表格等）完整插入到目标位置。
• 无需先创建externalDoc再提取文本，直接用Base64字符串调用该方法即可，简化流程同时保证内容完整性。

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