最省心的选择是直接用 github.com/sergi/go-diff，它稳定、无C依赖、支持行级和字符级diff及结构化patch；DiffLines适用于配置文件等行格式文本，DiffMain用于字符级精准比对，超大文本需哈希预检。
直接用 github.com/sergi/go-diff 是最省心的选择，它在 Go 生态里稳定、无 C 依赖、支持行级和字符级 diff，还能生成结构化 patch 对象；别自己手写 Myers 算法，也别默认选 go-difflib——它不支持 patch 应用，头信息字段还容易漏。
什么时候该调系统 diff，而不是纯 Go 库
需要标准 unified diff 文本（比如给 git apply 用）、或追求极致启动速度时，优先走 exec.Command("diff", "-u")。它的输出是 POSIX 兼容的，下游工具认得准。
- Windows 上必须预装
diffutils，否则exec.Command启动失败，不是代码 bug，是环境缺失 - Alpine 镜像里只有 busybox 版
diff，不支持-u，会静默退回到老式 normal 格式，导致git apply拒绝解析 -
diff的stderr为空 + 退出码为 1，只代表“有差异”，不是错误；退出码为 2 才真出错（如文件不存在、权限不足） - 二进制文件会输出
Binary files a and b differ，这是预期行为，别当成异常 panic
sergi/go-diff 的 DiffLines 和 DiffMain 怎么选
DiffLines 按换行符切分后比对，适合配置文件、日志、YAML/JSON 行格式文本；DiffMain 是字符级比对，能精准标出“第 3 行第 5 个字从 a 变成 b”，适合 UI 层高亮或审计场景。
-
DiffLines不自动归一化\r\n和\n，读文件后建议先strings.ReplaceAll(s, "\r\n", "\n") -
DiffMain第三个参数设为true会启用行启发式优化，但遇到超长单行（比如 minified JS）可能变慢甚至卡住，生产环境建议保持false - 两者都返回
[]diffmatchpatch.Diff，其中Text字段是原始字符串，含换行符；渲染前注意\n转义 - 超大文本（>10MB）慎用
DiffMain，内存占用直线上升，优先考虑哈希预检跳过
生成 patch 后怎么安全应用回原文
sergi/go-diff 的 PatchMake 返回的是结构化 []Patch，不是字符串；要转成人类可读格式得调 PatchToString，要应用得用 PatchApply。
立即学习“go语言免费学习笔记（深入）”；
-
PatchApply第二个参数是原文字符串，返回新字符串 + 成功标记切片；失败不 panic，而是对应位置标记false - 原文若被并发修改，
PatchApply可能部分失败，需检查返回的[]bool结果，不能只看 error - 不要把
PatchToString输出直接喂给git apply——它不是 unified diff 格式，是自定义 patch 表示 - 若需 RFC6902 JSON Patch，换用
github.com/evanphx/json-patch或github.com/mattbaird/jsonpatch，sergi/go-diff不处理 JSON 结构语义
最容易被忽略的是换行符和编码边界：Windows 文件读进来带 \r\n，Linux 是 \n，DiffLines 会把它们当不同行；UTF-8 多字节字符被截断会导致 DiffMain panic，所以传入前务必确保是合法 UTF-8 字符串，别直接喂 os.ReadFile 出来的 []byte。
