Open XML SDK 中 Word 文档修订跟踪的实现技巧

在文档协作和版本控制场景中，Word 的修订跟踪功能至关重要。本文将深入探讨如何使用 Open XML SDK 正确实现 Word 文档的修订跟踪功能，特别是处理插入和删除内容的标记问题。

修订跟踪的基本原理

Word 文档的修订跟踪功能通过特定的 XML 标记来实现。当开启"跟踪更改"功能时，Word 会：

1. 对新增内容使用 <w:ins> 标记
2. 对删除内容使用 <w:del> 标记
3. 记录修改作者和时间信息

常见问题分析

开发者在实现修订跟踪时经常遇到两个典型问题：

1. 删除内容无法正确显示为修订状态
2. 文档在 Word 中打开时出现兼容性问题

这些问题通常源于 XML 结构不符合 Word 的严格规范要求。

正确的实现方案

1. 删除内容的标记实现

删除内容必须使用专门的 <w:delText> 元素而非普通的 <w:t> 元素：

var deletedTextRun = new Run
{
    RunProperties = new RunProperties(new Color { Val = "FF0000" }) // 红色表示删除
};
deletedTextRun.AppendChild(new DeletedText(oldText)); // 关键点：使用DeletedText

2. 修订元素的完整属性

修订元素应包含完整的元数据：

var deletedRun = new DeletedRun
{
    Author = "作者名称",
    Date = DateTime.Now,
    Id = "唯一标识"  // 虽然不是必须，但Word习惯使用
};

3. 插入内容的标记实现

插入内容的处理相对简单，但仍需注意规范：

var insertedRun = new InsertedRun
{
    Author = "作者名称",
    Date = DateTime.Now,
    Id = "唯一标识"
};

完整实现示例

以下是处理段落中文本替换并标记修订的完整代码：

void TrackChangesInWord(string filePath, string newText, string oldText)
{
    using (WordprocessingDocument wordDoc = WordprocessingDocument.Open(filePath, true))
    {
        var body = wordDoc.MainDocumentPart.Document.Body;

        foreach (var paragraph in body.Elements<Paragraph>())
        {
            var runs = paragraph.Elements<Run>().ToList();
            string fullText = string.Join("", runs.Select(r => r.GetFirstChild<Text>()?.Text ?? ""));

            if (fullText.Contains(oldText))
            {
                int pos = fullText.IndexOf(oldText);
                
                // 清理原有内容
                runs.ForEach(r => r.Remove());

                // 添加修改前的内容
                if (pos > 0)
                    paragraph.AppendChild(new Run(new Text(fullText.Substring(0, pos))));

                // 标记删除内容
                var delRun = new DeletedRun { Author = "系统", Date = DateTime.Now, Id = "0" };
                delRun.AppendChild(new Run(
                    new RunProperties(new Color { Val = "FF0000" }),
                    new DeletedText(oldText)
                ));
                paragraph.AppendChild(delRun);

                // 标记新增内容
                var insRun = new InsertedRun { Author = "系统", Date = DateTime.Now, Id = "1" };
                insRun.AppendChild(new Run(
                    new RunProperties(new Color { Val = "00FF00" }),
                    new Text(newText)
                ));
                paragraph.AppendChild(insRun);

                // 添加剩余内容
                string remaining = fullText.Substring(pos + oldText.Length);
                if (!string.IsNullOrEmpty(remaining))
                    paragraph.AppendChild(new Run(new Text(remaining)));
            }
        }
    }
}

最佳实践建议

1. 颜色规范：遵循Word惯例，使用红色(FF0000)表示删除，绿色(00FF00)表示新增
2. ID管理：为每个修订分配唯一ID，便于追踪
3. 时间记录：确保记录准确的修改时间
4. 作者信息：使用有意义的作者标识
5. 性能考虑：处理大文档时注意内存管理和性能优化

通过遵循这些规范和实践，开发者可以可靠地实现Word文档的修订跟踪功能，确保生成的文档完全兼容Microsoft Word的显示和处理要求。