使用C# Microsoft.Word.Interop添加水印过慢，如何提速？

问题背景 #

现有通过Office Interop实现的Word文档水印添加功能可正常运行，但处理大文档或包含页眉图片等复杂格式的文档时速度过慢，以下是针对性的优化措施：

具体优化措施 #

1. 禁用更多Word自动化的非必要特性 #

在初始化Word应用时，除关闭ScreenUpdating外，额外关闭弹窗提示、禁用自动化安全检查，减少后台冗余操作：

Application wordApp = new Application();
wordApp.Visible = false;
wordApp.ScreenUpdating = false;
// 禁用所有弹窗提示
wordApp.DisplayAlerts = WdAlertLevel.wdAlertsNone;
// 禁用自动化安全警告
wordApp.AutomationSecurity = MsoAutomationSecurity.msoAutomationSecurityForceDisable;
// 关闭实时拼写/语法检查
wordApp.CheckSpellingAsYouType = false;
wordApp.CheckGrammarAsYouType = false;

2. 跳过不必要的Header处理 #

仅当文档启用「首页不同」或「奇偶页不同」设置时，才处理对应Header，避免无效的跨进程COM调用：

foreach (Microsoft.Office.Interop.Word.Section section in wordDoc.Sections)
{
    List<Microsoft.Office.Interop.Word.Shape> wordShapeList = new List<Microsoft.Office.Interop.Word.Shape>();

    // 处理主页眉（默认页面）
    var primaryHeader = section.Headers[WdHeaderFooterIndex.wdHeaderFooterPrimary];
    wordShapeList.Add(CreateWatermarkShape(primaryHeader));

    // 仅启用首页不同时处理首页页眉
    if (section.PageSetup.DifferentFirstPageHeaderFooter == WdConstants.wdTrue)
    {
        var firstPageHeader = section.Headers[WdHeaderFooterIndex.wdHeaderFooterFirstPage];
        wordShapeList.Add(CreateWatermarkShape(firstPageHeader));
    }

    // 仅启用奇偶页不同时处理偶数页页眉
    if (section.PageSetup.OddAndEvenPagesHeaderFooter == WdConstants.wdTrue)
    {
        var evenPagesHeader = section.Headers[WdHeaderFooterIndex.wdHeaderFooterEvenPages];
        wordShapeList.Add(CreateWatermarkShape(evenPagesHeader));
    }

    // 批量配置Shape属性
    foreach (var wordShape in wordShapeList)
    {
        ConfigureWatermarkShape(wordShape);
    }
}

3. 封装Shape创建与配置逻辑，减少重复代码 #

将水印Shape的创建和属性配置封装为独立方法，同时提前缓存常用枚举值，避免反复访问COM对象：

// 提前缓存枚举值，减少COM查找开销
private static readonly MsoPresetTextEffect _textEffect = MsoPresetTextEffect.msoTextEffect1;
private static readonly MsoTriState _msoTrue = MsoTriState.msoTrue;
private static readonly MsoTriState _msoFalse = MsoTriState.msoFalse;
private static readonly WdWrapType _wrapBehind = WdWrapType.wdWrapBehind;
private static readonly WdRelativeHorizontalPosition _horizMargin = WdRelativeHorizontalPosition.wdRelativeHorizontalPositionMargin;
private static readonly WdRelativeVerticalPosition _vertMargin = WdRelativeVerticalPosition.wdRelativeVerticalPositionMargin;

private static Microsoft.Office.Interop.Word.Shape CreateWatermarkShape(Microsoft.Office.Interop.Word.HeaderFooter header)
{
    object o = Missing.Value;
    return header.Shapes.AddTextEffect(
        _textEffect, 
        "© aQua-Institut GmbH", 
        "Calibri", 
        30f, 
        _msoTrue, 
        _msoFalse, 
        150, 
        350, 
        o);
}

private static void ConfigureWatermarkShape(Microsoft.Office.Interop.Word.Shape shape)
{
    var fill = shape.Fill;
    fill.Visible = _msoTrue;
    fill.Solid();
    fill.ForeColor.RGB = (int)WdColor.wdColorGray15;

    shape.Line.Visible = _msoFalse;
    shape.WrapFormat.AllowOverlap = -1;
    shape.WrapFormat.Type = _wrapBehind;
    shape.Rotation = -45;
    shape.RelativeHorizontalPosition = _horizMargin;
    shape.RelativeVerticalPosition = _vertMargin;
}

4. 移除不必要的文档激活操作 #

wordDoc.Activate()会触发Word的UI激活逻辑，完全无必要，直接删除该代码行。

5. 优化文档打开与保存参数 #

打开文档时设置只读模式（无需修改原文档时），减少文件锁和后台检查；保存时简化参数传递：

object o = Missing.Value;
object readOnly = true;
object noEncodingDialog = true;

// 优化打开参数
wordDoc = wordApp.Documents.Open(
    datei.pfad, 
    ref o, ref readOnly, ref o, ref o, ref o, ref o, ref o, ref o, ref o, 
    ref o, ref o, ref o, ref noEncodingDialog, ref o, ref o);

// 优化保存参数，使用默认值减少ref传递
wordDoc.SaveAs2(
    $@"{datei.neuesDateiverzeichnis}\{datei.neuerDateiname}.docx",
    ref o, ref o, ref o, ref o, ref o, ref o, ref o, ref o, ref o,
    ref o, ref o, ref o, ref o, ref o, ref o, ref o);

6. 及时释放COM对象（可选但推荐） #

处理完文档后显式释放COM对象，避免内存泄漏，加快进程退出速度：

// 释放Shape对象
foreach (var shape in wordShapeList)
{
    Marshal.ReleaseComObject(shape);
}
// 释放文档和应用对象
Marshal.ReleaseComObject(wordDoc);
wordDoc = null;
wordApp.Quit();
Marshal.ReleaseComObject(wordApp);
wordApp = null;
// 强制触发垃圾回收
GC.Collect();
GC.WaitForPendingFinalizers();

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