T工具箱
⑃

补丁生成

生成 Git 风格 unified diff

关于此工具

Git 差异补丁(Unified Diff / Patch,遵循 POSIX 与 Git 标准格式)是开源协作代码审查(Code Review)、跨离线物理机传输代码修复、Linux 内核社区邮件列表沟通及缺陷逆向回滚中最经典稳固的标准格式。Unified diff 格式通过在行首标注加号(`+` 新增)、减号(`-` 删除)以及 `@@ -l,s +l,s @@` 块头(Chunk Header)坐标系,以极小的文本体积记录代码演进。本工具提供纯前端本地 Unified Diff 补丁文件生成与解析,支持配置上下文行数、双向逆向补丁倒置,并一键复制标准 patch 代码。

如何使用本工具(操作步骤)

1

粘贴原始版本与修改后代码

在左侧粘贴修改前的原始代码/文本(Original),在右侧粘贴修改后的全新代码/文本(Modified)。

2

配置上下文行数与元标头

设置上下文对比行数(Context Lines,默认 3 行),并输入文件路径名称(如 `a/src/index.ts` 与 `b/src/index.ts`)。

3

一键导出标准 .patch 补丁文件

系统实时基于 Myers 差异算法生成标准的 Unified Diff 文本,点击一键下载 `.patch` 文件或复制在终端通过 `git apply` 应用。

严格遵循标准 Git Unified Diff Hunk 块头语法

精准计算并输出 `@@ -1,5 +1,6 @@` 块头坐标范围,确保生成的补丁文件 100% 能被原生 `git apply` 或 `patch -p1` 识别无报错。

支持一键反向倒置补丁 (Reverse Patch)

支持一键将新增与删除互调,生成用于紧急回滚故障代码的反向撤销补丁,极大提升生产排错应变能力。

纯本地离线计算,核心源码绝不泄露

所有文本逐行比对在浏览器本地 Web Worker 中运算完成,企业机密商业源码与漏洞修补补丁绝不上报任何远程服务器。

Git 补丁制作避坑指南与跨平台行尾常识

  • •跨平台换行符陷阱(CRLF vs LF):在 Windows 下生成的补丁如果带 ` `,应用到 Linux 服务器上可能会提示 `patch does not apply` 报错!建议在生成补丁前统一将换行符规整为 Linux 标准的 ` `(LF)。
  • •上下文行数(Context Lines)不要设为 0:虽然去掉上下文行能压缩补丁体积,但一旦目标文件在前后行数发生了哪怕 1 行微小漂移,`patch` 命令就会彻底丢失定位坐标导致应用失败!建议保持默认 3 行上下文。
  • •末尾“没有换行符(No newline at end of file)”报警:如果在代码末尾漏掉了回车换行,Git 补丁中会打印特殊的 `\ No newline at end of file` 标记。在现代代码规范中,所有文件末尾都应强制保留一个空行换行。

代码与转换对比示例

标准 Git Unified Diff 补丁文件解构对照表

生成的标准 .patch 文本
--- a/src/config.ts
+++ b/src/config.ts
@@ -10,4 +10,5 @@
 const port = 3000;
-const debug = false;
+const debug = true;
+const timeout = 5000;
 export default config;
语法标签含义解构
• --- 与 +++ : 指示被对比的旧文件路径与新文件路径
• @@ -10,4 +10,5 @@ : 坐标定位头 (原文件从第10行起占4行,新文件从第10行起占5行)
• 空格开头行 : 未变动的上下文对照行 (保证 patch 能被精准定位)
• - 减号开头  : 本次被删除的旧代码行
• + 加号开头  : 本次被新增的新代码行

* 空格开头的上下文行是 patch 工具模糊匹配定位代码插槽的核心依据。

Linux 终端使用 git apply 应用补丁命令范式

常用终端操作命令
# 1. 预先检查补丁是否能干净应用 (不修改实际文件)
git apply --check fix.patch

# 2. 正式应用补丁并修改工作区
git apply fix.patch

# 3. 逆向回滚撤销该补丁
git apply -R fix.patch
遇到冲突时的技巧
若原文件有微小变动导致冲突,追加 --reject 参数(git apply --reject fix.patch),能将未能合入的冲突行单独导出为 .rej 文件人工核对!

* 使用 `git apply --check` 是在生产环境部署热修复补丁的最佳安全防御姿势。

常见问题解答

Q: 为什么有了 GitHub PR,大型开源项目(如 Linux 内核)依然偏好发补丁?

A: 因为补丁文件是纯文本,可以直接嵌入纯文本电子邮件正文进行逐行评论回复,审阅者甚至可以在无网络离线状态下用终端命令行查看并编译测试,完全不受制于特定商业 Web 平台的界面与网络限制。

Q: 补丁文件(.patch)与 Git Commit 提交有什么联系?

A: `git diff` 生成的补丁仅包含代码增删差异;而 `git format-patch` 会将提交作者、提交邮箱、Commit Message 说明以及 PGP 签名全部打包进补丁中,其他人使用 `git am` 可以完整还原带历史记录的 Commit。

Q: 面对上万行的大型文件,生成补丁性能如何?

A: 本工具基于高度优化的 Myers O(ND) 差分算法构建,对于数万行代码的全文扫描与差异提取耗时通常在几十毫秒以内,毫无卡顿假死,稳定秒出结果。

相关推荐工具

所有处理都在你的浏览器本地完成,数据不会上传到服务器。
/