# textkit.diff 库模块帮助文档

[文本差异与 Unified Diff](https://www.aardio.com/zh-cn/docs/library/textkit/diff/index.html)

## textkit 成员列表 <a id="textkit" href="#textkit">&#x23;</a>

### textkit.diff(oldText,newText,options?) <a id="textkit.diff" href="#textkit.diff">&#x23;</a>
对比 UTF-8 文本 → 单个结果表。  
失败有 error；成功用 diff、summary、identical、contentIdentical 查看结果。  
options：format="autos"（默认）或 "unified"；context=3；maxBytes（Autos 默认 8000）；label（Unified 的目标相对路径）。

## textkit.diff 成员列表 <a id="textkit.diff" href="#textkit.diff">&#x23;</a>

按行对比两段文本或两个文件。默认返回带新文件行号的 Autos 预览；format="unified" 生成标准补丁。不改动文件、不依赖 Git。

### textkit.diff.files(oldPath,newPath,options?) <a id="textkit.diff.files" href="#textkit.diff.files">&#x23;</a>
只读对比两个文件 → 单个结果表。  
默认 UTF-8；识别 UTF-8/UTF-16LE/UTF-16BE BOM 并转 UTF-8。任一侧有 BOM 才返回 charset="旧编码->新编码"。  
选项与 textkit.diff 相同；Unified 补丁针对解码后的 UTF-8 文本，不修改编码/BOM。
