C# 中生成带语法高亮的 HTML diff 最稳方案是 DiffPlex v4+，它原生支持行级与字符级差异、输出 / HTML 片段，并需配合预处理换行符、BOM、全角空格及后端语法高亮器（如 CodeHighlighter）实现 GitHub 风格效果。
用 DiffPlex 生成带语法高亮的 HTML diff
直接上结论：C# 里最稳、最轻、最贴 GitHub 风格的方案是 DiffPlex（v4+），它原生支持行级 + 字符级差异，还能输出带 <ins></ins>/<del></del> 的 HTML 片段，配合简单 CSS 就能接近 GitHub 的视觉效果。
别自己解析行差再拼 HTML —— 容易漏空格、制表符、换行符归一化问题，DiffPlex 内部已处理好这些边界。
实操建议：
- 安装
DiffPlexNuGet 包：Install-Package DiffPlex（注意选DiffPlex，不是DiffPlex.Core） - 用
InlineDiffBuilder而非SideBySideDiffBuilder，后者只适合左右对比，GitHub 是行内高亮（比如var x = 1;→var x = 2;只标红1和2） - 调用前务必 Normalize 换行符：
text1 = text1.Replace("\r\n", "\n").Replace("\r", "\n")，否则DiffPlex可能误判整行为差异 - 输出 HTML 后，加一行
<style>.diff-ins { background-color: #e6ffed; } .diff-del { background-color: #ffeef0; text-decoration: line-through; }</style>即可快速对齐 GitHub 色系
DiffPlex 默认不渲染语言语法，怎么加高亮？
DiffPlex 只负责“哪里变了”，不管“变的是什么语言”。想让 if (x > 0) 里的 if 蓝色、x 灰色，得自己后处理 HTML —— 但别手写正则匹配关键字，容易崩。
立即学习“前端免费学习笔记（深入）”；
实操建议：
- 先用
DiffPlex生成含<ins></ins>/<del></del>的 HTML 字符串 - 再把整个 HTML 块丢给轻量语法高亮器，比如
highlight.js（前端）或CodeHighlighter（C# 后端，支持 C#, JSON, XML 等） - 关键点：高亮器必须作用于
<ins></ins>和<del></del>内部文本，而不是整块 pre —— 否则会覆盖掉 diff 样式。推荐用HtmlAgilityPack解析，定位所有<ins></ins>/<del></del>节点，对其InnerHtml单独高亮，再写回 - 如果只支持有限语言（如仅 C#），可用
Microsoft.CodeAnalysis提取语法树，但性能开销大，日常 diff 场景没必要
中文、全角空格、BOM 头导致 diff 错乱怎么办？
常见现象：两份内容明明一样，DiffPlex 却标出整行差异；或者“测试”和“测试”看着一样，diff 却显示不同 —— 很大概率是编码或不可见字符惹的祸。
实操建议：
- 读文件时强制指定编码：
File.ReadAllText(path, Encoding.UTF8)，别用无参重载（可能触发 BOM 自动检测失败） - 检查并剥离 BOM：
if (text.StartsWith("\uFEFF")) text = text.Substring(1); - 全角空格（
\u200B）一律视作干扰项。预处理时用Regex.Replace(text, @"[\u3000\u00A0\u200B-\u200F\u2028-\u202F]", " ")统一替换为空格再 trim - Windows 下用
\r\n，Linux/macOS 用\n，diff 前统一成\n，否则DiffPlex会把换行符本身当作差异
性能瓶颈在哪？大文件（>10MB）怎么扛住？
DiffPlex 在 5000 行以内几乎无感，但一旦文件超 10MB 或单行超 10KB，内存暴涨、GC 频繁、响应卡顿就来了 —— 根本原因不是算法慢，而是它默认把全文加载进内存做字符串比对。
实操建议：
- 别 diff 整个 10MB 文件。按逻辑切分：比如日志文件按时间戳切段，源码按类/方法切块，只 diff 变更的 chunk
- 用
DiffPlex的ComputeDiff重载传入DiffPaneModel，手动控制比较范围（例如只比第 100–150 行） - 禁用字符级 diff：
new InlineDiffBuilder(new DifferOptions { DetectAllMoves = false })，行级 diff 足够应对绝大多数场景，且快 3–5 倍 - 缓存 diff 结果：相同两个文件哈希值一致时，直接返回上次生成的 HTML，避免重复计算
真正难的不是生成 HTML，是让 diff 结果在语义上“可读”——比如合并多行空白变更、忽略注释变动、跳过自动生成代码块。这些得靠业务规则前置过滤，DiffPlex 不管也管不了。
