### 一、 项目目标与方案设计 目标是开发一个基于C# WinForm的文本比对工具，核心需求为：1) 使用DiffPlex库进行文本差异比对；2) 将差异结果（原始文本与对比文本）分别显示在两个`RichTextBox`控件中；3) 使用不同的背景色（底色）高亮显示差异行；4) 实现两个`RichTextBox`的同步滚动。为了达成此目标，需综合利用`RichTextBox`的富文本格式化能力、`DiffPlex`的差异计算功能以及控件间的滚动同步机制[ref_2]。 ### 二、 核心步骤与实现代码 #### 1. 环境配置与界面布局 首先，创建一个C# WinForm项目，通过NuGet包管理器安装`DiffPlex`包。界面设计主要包含两个`RichTextBox`控件（命名为`rtbSource`和`rtbTarget`）用于并列显示文本，以及必要的按钮（如“加载文件”、“比较”）。 核心窗体的初始化及控件加载代码如下： ```csharp // 示例：主窗体Form1的Designer.cs片段 // 此处声明了两个RichTextBox，并设置其Dock属性为Fill，以便于分割显示 private System.Windows.Forms.SplitContainer splitContainer1; private System.Windows.Forms.RichTextBox rtbSource; private System.Windows.Forms.RichTextBox rtbTarget; // ... 以及比较按钮等控件 ``` #### 2. 使用DiffPlex计算文本差异 `DiffPlex`的`Differ`类是核心，它能够计算两段文本之间的差异，并返回一个`DiffResult`对象，其中包含了详细的差异信息[ref_3]。 ```csharp using DiffPlex; using DiffPlex.DiffBuilder; using DiffPlex.DiffBuilder.Model; private void CompareTexts(string oldText, string newText) { // 创建差异比较器 var differ = new Differ(); // 使用内联差异生成器（InlineDiffBuilder）获取详细的差异模型 var builder = new InlineDiffBuilder(differ); var diffResult = builder.BuildDiffModel(oldText, newText); // 调用后续方法，将差异模型应用于RichTextBox显示 ApplyDiffToRichTextBox(rtbSource, diffResult, false); // 显示旧文本，标记被删除部分 ApplyDiffToRichTextBox(rtbTarget, diffResult, true); // 显示新文本，标记新增或修改部分 } ``` #### 3. 在RichTextBox中渲染差异（设置底色） `RichTextBox`通过`SelectionBackColor`属性可以设置选定文本的背景色[ref_1]。我们将遍历`DiffResult`的每一行，根据其`ChangeType`（`Deleted`， `Inserted`， `Unchanged`）为整行设置不同的背景色[ref_3]。 ```csharp private void ApplyDiffToRichTextBox(RichTextBox rtb, DiffPaneModel diffModel, bool isNewTextSide) { rtb.Clear(); // 确保文本改变不会触发不必要的滚动事件 rtb.SuspendLayout(); foreach (var line in diffModel.Lines) { // 根据差异类型决定背景色 Color backColor = Color.White; // 默认白色 switch (line.Type) { case ChangeType.Deleted: backColor = isNewTextSide ? Color.White : Color.LightCoral; // 旧文本侧显示删除 break; case ChangeType.Inserted: backColor = isNewTextSide ? Color.LightGreen : Color.White; // 新文本侧显示新增 break; case ChangeType.Modified: // 修改的行，可以根据需要设置不同颜色，例如浅黄色 backColor = Color.LightYellow; break; case ChangeType.Unchanged: default: break; } // 将文本追加到RichTextBox rtb.AppendText(line.Text + Environment.NewLine); // 为新追加的这行设置背景色 int lineStart = rtb.GetFirstCharIndexFromLine(rtb.Lines.Length - 1); int lineLength = line.Text.Length; if (lineStart >= 0) { rtb.Select(lineStart, lineLength); rtb.SelectionBackColor = backColor; // 取消选择，避免影响后续操作 rtb.Select(0, 0); } } rtb.ResumeLayout(); // 滚动到顶部 rtb.ScrollToCaret(); } ``` 此方法的核心在于逐行处理差异模型：对于旧文本（左侧`RichTextBox`），我们为`Deleted`行设置背景色；对于新文本（右侧`RichTextBox`），我们为`Inserted`行设置背景色；`Modified`行在两个框中都可能被标记[ref_5]。 #### 4. 实现两个RichTextBox的同步滚动 同步滚动是指当用户滚动其中一个`RichTextBox`的垂直滚动条时，另一个控件自动滚动到相同的位置。这可以通过处理`RichTextBox`的`VScroll`事件来实现。基本原理是，当一个控件的滚动位置发生变化时，计算其第一行可见行的索引，然后设置另一个控件的相应滚动位置[ref_2]。 ```csharp private bool isSyncingScroll = false; // 标志位，防止事件循环触发 private void SetupSynchronizedScrolling() { rtbSource.VScroll += (sender, e) => SyncScrollPosition(rtbSource, rtbTarget); rtbTarget.VScroll += (sender, e) => SyncScrollPosition(rtbTarget, rtbSource); } private void SyncScrollPosition(RichTextBox source, RichTextBox target) { if (isSyncingScroll) return; isSyncingScroll = true; try { // 获取源控件当前可见区域的第一行索引 int sourceFirstVisibleLine = source.GetCharIndexFromPosition(new Point(0, 0)); sourceFirstVisibleLine = source.GetLineFromCharIndex(sourceFirstVisibleLine); // 计算目标控件需要滚动到的字符位置 int targetCharIndex = target.GetFirstCharIndexFromLine(sourceFirstVisibleLine); // 确保索引有效 if (targetCharIndex >= 0) { target.ScrollToCaret(); // 先重置一下 target.Select(targetCharIndex, 0); target.ScrollToCaret(); } } finally { // 短暂延迟后释放锁，确保滚动平滑 Task.Delay(10).ContinueWith(_ => isSyncingScroll = false); } } ``` 此方法通过`GetCharIndexFromPosition`和`GetLineFromCharIndex`等`RichTextBox`方法精确获取和设置滚动位置[ref_1]。`isSyncingScroll`标志位用于防止两个控件的事件互相触发导致死循环或闪烁。 ### 三、 综合应用与优化示例 以下是一个整合了文件加载和比较功能的按钮点击事件处理示例，展示了完整的工作流： ```csharp private void btnCompare_Click(object sender, EventArgs e) { // 假设textOld和textNew是从文本框或文件加载的文本 string textOld = rtbSource.Text; // 或者从文件读取 string textNew = rtbTarget.Text; if (string.IsNullOrEmpty(textOld) || string.IsNullOrEmpty(textNew)) { MessageBox.Show("请先加载或输入需要比较的文本。"); return; } // 步骤1: 计算差异 var differ = new Differ(); var builder = new InlineDiffBuilder(differ); var diffResult = builder.BuildDiffModel(textOld, textNew); // 步骤2: 渲染差异到两个RichTextBox ApplyDiffToRichTextBox(rtbSource, diffResult, false); ApplyDiffToRichTextBox(rtbTarget, diffResult, true); // 步骤3: 初始化同步滚动 (在窗体加载时执行一次即可) // SetupSynchronizedScrolling(); } ``` 在实际开发中，可以扩展此基础功能，例如添加行号显示、支持文件拖拽加载、将差异导出为HTML报告等[ref_2][ref_6]。通过`DiffPlex`的高效差异算法和`RichTextBox`灵活的格式化能力，能够构建出一个功能实用且用户体验良好的本地文本比对工具[ref_4]。