在Excel中使用IPersistFile.Save无法获取本地副本且替换当前文档

为什么IPersistFile.Save会替换当前文档？ #

这并非API Bug，而是IPersistFile接口的设计场景与Office在线文档的运行逻辑不匹配。IPersistFile是为本地文件的持久化操作设计的，而从Teams/SharePoint打开的Excel文档属于云托管文档，Excel通过专属同步机制维护其与云端的关联。调用IPersistFile.Save(path, false)时，会强制修改当前工作簿的持久化路径，导致Excel将本地副本视为新的编辑对象，从而断开与云端的同步连接。

替代方案：不改变当前文档的副本获取方法 #

方法1：使用Workbook.SaveCopyAs方法 #

这是Excel对象模型中专门用于创建文档副本的API，不会修改当前打开文档的关联路径，完美适配在线文档场景：

this.Application.WorkbookOpen += (Excel.Workbook wb) =>
{
    if (!Uri.TryCreate(wb.FullName, UriKind.Absolute, out Uri uri) || uri.Scheme == "file")
    {
        Debug.WriteLine($"本地文件: {wb.FullName}");
        return;
    }
    Debug.WriteLine($"在线文件: {wb.FullName}");

    var fileName = uri.LocalPath.Split('/').Last();
    var extension = Path.GetExtension(fileName);
    var fileNameWithoutExtension = Path.GetFileNameWithoutExtension(fileName);
    var path = Path.Combine(Path.GetTempPath(), $"{fileNameWithoutExtension}_{Guid.NewGuid()}{extension}");

    // 使用SaveCopyAs创建副本，不影响当前编辑的云端文档
    wb.SaveCopyAs(path);
    Debug.WriteLine($"本地副本已创建: {path}");
};

方法2：使用Office File API的SaveCopyAsync（适用于较新版本Office） #

如果插件面向Office 365或较新的Excel版本，可以使用异步的SaveCopyAsync方法，避免UI阻塞：

await wb.SaveCopyAsync(path);

方法3：通过Graph API直接下载云端文件 #

如果插件具备对应权限，可以调用Microsoft Graph API直接从SharePoint/Teams的文档库下载文件，无需依赖Excel对象模型。这种方式完全独立于当前编辑的文档，不会影响同步，但需要处理身份验证和权限逻辑。

关键注意点 #

• 避免对云托管文档使用IPersistFile接口的持久化方法，这类接口仅适用于本地文件场景。
• 使用Excel原生的SaveCopyAs或SaveCopyAsync是最稳妥的方案，既保证副本生成，又不破坏云端同步链路。

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