VSTO插件中使用UndoRecord.StartCustomRecord时，编号/项目符号场景下撤销栈异常的问题排查与正确实现咨询

你遇到的这个问题其实在Word Interop的UndoRecord使用中不算少见，尤其是涉及到编号/项目符号这类和段落格式强关联的操作时，很容易触发撤销栈的异常行为。我来帮你拆解下问题原因和可行的解决思路：

一、问题根源分析 #

Word的撤销栈对于“结构化”操作（比如编号、项目符号这类依赖段落集合联动的格式）的处理逻辑和普通文本替换/样式设置不一样：

1. 编号/项目符号的底层特性：当你给段落添加编号或项目符号后，Word会把这些段落纳入一个“列表容器”中，段落之间的格式关联性变强。此时执行批量的ReplaceAll或者遍历段落设置样式，Word内部可能会生成多个独立的撤销步骤，这些步骤会“突破”UndoRecord的包裹，导致自定义撤销记录失效。
2. Find.Execute(ReplaceAll)的特殊行为：wdReplaceAll操作本身在处理带列表的文档时，Word会为每个被替换的段落生成单独的撤销项，即使你用了UndoRecord包裹，它也可能因为内部的批量处理逻辑“逃逸”出去，破坏自定义撤销记录的完整性。
3. 段落遍历的副作用：遍历document.Paragraphs并设置样式时，对于列表中的段落，Word会额外记录列表结构的变更，这些操作同样可能脱离自定义撤销记录的范围，导致撤销栈混乱。

二、修正后的实现方案 #

针对这些问题，我们可以调整代码逻辑，让所有操作严格被UndoRecord包裹，同时规避Word内部的特殊处理逻辑：

1. 替换ReplaceAll为逐次替换 #

避免使用wdReplaceAll，改为循环执行单次替换，这样可以让每个替换操作都被纳入自定义撤销记录：

Word.Range currentRange = Globals.ThisAddIn.Application.Selection.Range;
var application = Globals.ThisAddIn.Application;
var document = application.ActiveDocument;
this.undoRecord = application.UndoRecord;
this.undoRecord.StartCustomRecord("MyRecord");

// 替换段落换行：改为逐次替换，避免wdReplaceAll的逃逸问题
string replacementText = "";
Word.Find find = currentRange.Find;
find.ClearFormatting();
find.Replacement.ClearFormatting();
find.Text = "^p";
find.Replacement.Text = replacementText;
find.Forward = true;
find.Wrap = Word.WdFindWrap.wdFindStop;
find.Format = false;
find.MatchCase = false;
find.MatchWholeWord = false;
find.MatchWildcards = false;

// 循环执行单次替换，直到找不到匹配项
while (find.Execute(Replace: Word.WdReplace.wdReplaceOne))
{
    // 保持当前范围为替换后的位置，继续查找
    currentRange = find.Parent;
    find = currentRange.Find;
    // 重置查找参数（避免状态残留）
    find.ClearFormatting();
    find.Replacement.ClearFormatting();
    find.Text = "^p";
    find.Replacement.Text = replacementText;
}

// 样式设置：改为基于当前选择范围或者指定范围的批量设置，而非遍历所有段落
// 这里可以优化为只处理选中范围的段落，避免影响整个文档
Word.Range allParagraphsRange = document.Content;
allParagraphsRange.set_Style(Microsoft.Office.Interop.Word.WdBuiltinStyle.wdStyleEmphasis);

this.undoRecord.EndCustomRecord();

2. 合并范围操作，减少遍历 #

不要单独遍历每个段落，而是直接对整个文档的内容范围设置样式，这样Word会把样式设置作为一个单一操作纳入撤销记录，避免遍历带来的多步骤问题。

3. 额外的校验与强化 #

在执行操作前可以判断this.undoRecord.IsRecording是否为true，确保自定义记录处于激活状态，避免因意外情况导致的记录失效：

if (!this.undoRecord.IsRecording)
{
    this.undoRecord.StartCustomRecord("MyRecord");
}

三、验证方法 #

按照以下步骤测试修正后的代码：

• 新建文档，添加多个段落，设置编号/项目符号。
• 执行插件中的自定义操作。
• 打开撤销菜单（Ctrl+Z），应该能看到唯一的"MyRecord"撤销项。
• 执行撤销后，检查文档是否回到操作前的状态，同时确认之前的撤销项依然可用。

内容来源于stack exchange