如何在桌面版Excel插件中用Office.context.ui.openBrowserWindow下载Base64文件

桌面版Excel（Windows/Mac）的插件环境不支持浏览器原生的Blob对象URL下载逻辑，直接将URL.createObjectURL生成的地址传给Office.context.ui.openBrowserWindow会失效——因为该对象URL仅在插件的上下文内有效，外部浏览器无法访问。以下是两种可行的解决方案：

方案一：内嵌HTML页面的Data URI（适合小文件） #

直接构造包含自动下载逻辑的HTML页面Data URI，传给openBrowserWindow后，浏览器会自动触发下载并关闭页面：

function downloadBase64File() {
    const sampleBase64Data = 'VGVzdCBhdHRhY2htZW50';
    const fileName = 'sampleFile.txt';
    
    // 构造包含下载逻辑的内嵌HTML页面
    const downloadPage = `
        <html>
            <body>
                <a id="dlLink" href="data:application/octet-stream;base64,${sampleBase64Data}" download="${fileName}"></a>
                <script>
                    document.getElementById('dlLink').click();
                    setTimeout(() => window.close(), 500);
                </script>
            </body>
        </html>
    `;
    // 将HTML转为Data URI
    const dataUri = `data:text/html;charset=utf-8,${encodeURIComponent(downloadPage)}`;
    
    Office.context.ui.openBrowserWindow(dataUri);
}

方案二：静态HTML页面接收参数（适合大文件） #

如果文件体积较大（Data URI存在长度限制），可以在插件资源中放置一个静态HTML页面，通过URL参数传递Base64数据，页面内处理下载逻辑：

1. 插件中添加download.html文件 #

<!DOCTYPE html>
<html>
<body>
<script>
    const params = new URLSearchParams(window.location.search);
    const base64Data = params.get('data');
    const fileName = params.get('filename') || 'downloadedFile.txt';

    if (base64Data) {
        // 解码Base64并转为Blob
        const binaryStr = atob(base64Data);
        const uint8Arr = new Uint8Array(binaryStr.length);
        for (let i = 0; i < binaryStr.length; i++) {
            uint8Arr[i] = binaryStr.charCodeAt(i);
        }
        const blob = new Blob([uint8Arr], { type: 'application/octet-stream' });

        // 触发下载
        const dlLink = document.createElement('a');
        dlLink.href = URL.createObjectURL(blob);
        dlLink.download = fileName;
        dlLink.click();

        // 清理并关闭窗口
        setTimeout(() => {
            URL.revokeObjectURL(dlLink.href);
            window.close();
        }, 1000);
    }
</script>
</body>
</html>

2. 插件主代码中调用 #

function downloadLargeBase64File() {
    const sampleBase64Data = 'VGVzdCBhdHRhY2htZW50';
    const fileName = 'sampleFile.txt';
    
    // 编码参数避免特殊字符截断
    const encodedData = encodeURIComponent(sampleBase64Data);
    const encodedFileName = encodeURIComponent(fileName);
    // 构造静态页面的访问地址（根据插件目录结构调整路径）
    const downloadUrl = `../assets/download.html?data=${encodedData}&filename=${encodedFileName}`;
    
    Office.context.ui.openBrowserWindow(downloadUrl);
}

注意事项 #

• 大文件使用Base64编码会使体积增加约30%，若文件过大建议优先考虑后端接口中转。
• Mac版Excel调用openBrowserWindow会打开系统默认浏览器，需确保浏览器允许自动下载。
• 传递Base64参数时必须用encodeURIComponent编码，防止特殊字符导致参数丢失。

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