统一差异格式

Unified diff

学到认得就够：听到能明白

你可能会说

“我审阅 AI 给分析脚本的改动时看到 ---、+++ 和 @@，这些标记各是什么意思？”

这是一种把旧文件与新文件放在同一份文本里展示的差异格式。文件头标记比较对象，差异块标记位置，每行前面的符号标记保留、移除或加入，便于人和工具读取。

先知道差异比较

也叫unified format、unidiff、diff -u

使用 AI

科研里的例子

审阅AI修改的文献笔记，确认因果措辞被改成相关性措辞，而来源页码未变。

典型文件头用---表示旧侧、+++表示新侧；块头用@@给出两侧行号范围。块内空格开头是上下文，减号是旧侧移除，加号是新侧加入。Git还可能增加模式、重命名等扩展头，所以不能只读红绿颜色。

动手试一次

对照本册diff示例，分别圈出文件头、块头和内容行。

在你的学科里，直接拿去用

查错并交付能核验的修复

请定位问题并给最小修复。
代码与环境：[粘贴]
输入样例：[不含私密信息的小样本]
实际错误或输出：[粘贴]
我期望：[填写]
先区分已观察事实与可能原因，优先用最小样例验证。解释根因，给最小差异和有意义的检查。没有实际运行权限时明确标为未运行建议，不把推测写成测试通过。若修改会影响研究规则或结果，指出具体影响，不顺手重构无关部分。

方括号里的内容换成你自己的。来自知识增量《科研中英表达与 Prompt 指南》PG09

判断

亲手检查一次

手算旧侧和新侧各有多少行，检查是否与块头范围吻合。

它做不到的

Git的合并差异等其他格式可能有不同的块头；本条讲普通两侧unified diff。

增量，由你来写

读完这张，你的理解变了什么？

留言功能会在后面的版本开放。现在可以先在 X 上 @knowledgedelta 告诉我。

源

来源

GNU diffutils — Detailed unified format2026-11-07 核对
Git — Generating patch text2026-11-07 核对

卡片底稿由 AI 协助整理，经过核对；发现错误请告诉我。