使用 diff 和 patch 命令协同开发

简介: 使用 diff 和 patch 命令协同开发

大家好,我是良许。

之前我在公司上班的时候,需要经常跟外国同事一起协同开发(之前在外企上班)。由于是异地协作,所以沟通几乎全部是通过邮件。

我们有使用 Git 进行代码版本管理,但有时为了快速验证,外国同事非常喜欢发个 patch 包过来让我们做测试。这也是我第一次在工作中使用 diffpatch 命令。

简单来讲,diff 命令可以用来创建一个差异文件,然后接收者可以使用 patch 命令将这部分差异代码应用到自己的代码里,达到协同开发的目的。

本文我们就来聊聊,怎么使用 diffpatch 命令进行协作开发。

微信图片_20220419171445.jpg

一个简单的例子

大家的业务及所使用的编程语言都不一样,所以为了便于叙述与理解,这里不使用具体的代码,而是一起编写一个具有一定逻辑的步骤文档。

假设你和我正在合作编写一个描述如何泡茶的文件。

下面是你写的代码部分:

Boil water.
Warm the teapot.
Add tea and water to the teapot.
Place a tea cosy over the teapot.
Steep for 6 minutes.
Pour tea into cup.
Add milk.

你家不种茶,也没有泡茶经验,所以这里有很多优化空间。

我家毕竟是多年种茶老司机,也培养出多名优秀的卖茶女业务代表,所以我大笔一挥,改进了一下泡茶步骤。

我先将文件复制为 tea-revision.md ,然后在此基础上进行修改,得到以下内容:

Warm a teapot in the proving drawer of your oven.
Boil water.
Add tea leaves to a tea strainer.
Add strainer and water to teapot.
Steep for 6 minutes. Keep it warm with a tea cosy.
Pour tea into cup.
Optionally, add warm milk.

在这里,有几行代码语句没有任何改动,比如 Boil waterPour tea into cup ;新增了几行代码,比如第一行 ,而有些行则进行了改动(增加或减少了部分内容)。

这么优秀的代码,你不应用的话太可惜了~

微信图片_20220419171448.jpg

使用diff命令创建差异

我如果直接把写好的代码丢给你,你肯定一头雾水,需要自己去对比两份代码的差异,费时费力。这时 diff 命令就派上用场了。

diff 命令可以直观显示两个文件之间的差异,使用 --unified (或者简写为 -u)选项可以显示哪些行被添加或删除。默认情况下,diff 会将差异结果输出打印到终端。

$ diff --unified tea.md tea-revised.md 
--- tea.md      2021-11-13 10:26:25.082110219 +1300
+++ tea-revised.md      2021-11-13 10:26:32.049110664 +1300
@@ -1,7 +1,7 @@
+Warm a teapot in the proving drawer of your oven.
 Boil water.
-Warm the teapot.
-Add tea and water to the teapot.
-Place a tea cosy over the teapot.
-Steep for 6 minutes.
+Add tea leaves to a tea strainer.
+Add strainer and water to teapot.
+Steep for 6 minutes. Keep it warm with a tea cosy.
 Pour tea into cup.
-Add milk.
+Optionally, add warm milk.

在这个差异显示中,加号 ( + ) 表示添加到原文件中的内容,而减号 ( - ) 表示删除或更改的行。

根据差异创建patch文件

现在我们有了两份代码的差异部分了,我们可以根据差异生成补丁文件。patch 文件的生成很简单,只需要使用标准 Bash 重定向将 diff 命令的结果输出就行了:

$ diff -u tea.md tea-revised.md > tea.patch

该文件的内容与输出到终端的内容完全相同,我们可以使用 catvim 命令来查看这个文件。说个题外话,使用 Emacs 工具来查看的话,它会根据每行是被添加还是被减去来对每一行使用颜色区分,非常直观。

微信图片_20220419171450.jpg

使用patch文件应用更改

当我生成好了补丁文件之后,我就可以将它发给你(QQ/微信,邮件,或者其它方式都行),你就可以将它应用到你的旧文件中。

这里我们需要使用 patch  命令应用补丁:

$ patch tea.md tea.patch

应用了补丁之后,你就得到了一个与我的版本相同的文件:

$ cat tea.md
Warm a teapot in the proving drawer of your oven.
Boil water.
Add tea leaves to a tea strainer.
Add strainer and water to teapot.
Steep for 6 minutes. Keep it warm with a tea cosy.
Pour tea into cup.
Optionally, add warm milk.

随着开发的进行,我们会进行多次代码增减,在这过程中我们可以多次生成补丁并应用,然后互相审核,一起为代码做贡献。

命令安装

在 Linux 和 macOS 系统上,已经默认拥有 diffpatch 命令。但在 Windows 系统上就需要自己安装了,一个简单的方法就是通过 Cygwin 来获得这两个命令。

如果你曾尝试通过邮件或微信来协作处理文件,并且发现自己试图描述需要进行更改的位置,那么 diffpatch 这两个工具非常适合你,可以省去很多沟通成本。

目录
相关文章
|
前端开发 定位技术
|
缓存 NoSQL Java
分布式锁有哪些应用场景和实现?
电商网站都会遇到秒杀、特价之类的活动,大促活动有一个共同特点就是访问量激增,在高并发下会出现成千上万人抢购一个商品的场景。虽然在系统设计时会通过限流、异步、排队等方式优化,但整体的并发还是平时的数倍以上,参加活动的商品一般都是限量库存,如何防止库存超卖,避免并发问题呢?分布式锁就是一个解决方案。
780 0
|
异构计算
PCIe链路训练(Link Training) Debug案例解析
有关Xilin FPGA开发版PCIe link up issue debug过程的文章,小编把里面提到的一个案例在这里给大家分享一下。
|
Linux
diff与patch的使用
diff与patch的使用
191 1
|
JavaScript
Vue3分段控制器(Segmented)
这是一个基于 Vue 的分段控制器组件 `Segmented`,支持多种选项和自定义渲染。通过 `v-model` 绑定当前选中值,并提供 `block`、`disabled` 和 `size` 等属性来调整样式。
382 0
Vue3分段控制器(Segmented)
|
程序员 API C语言
超详细实现【贪吃蛇】(1)
超详细实现【贪吃蛇】(1)
159 2
HuggingFace Tranformers 源码解析(3)
HuggingFace Tranformers 源码解析
248 0
|
XML 缓存 Java
解锁Spring Boot AOP的魔力:优雅地管理交叉关注点
解锁Spring Boot AOP的魔力:优雅地管理交叉关注点
517 0
|
NoSQL Java API
Java 最常见的面试题:jedis 和 redisson 有哪些区别?
Java 最常见的面试题:jedis 和 redisson 有哪些区别?
|
缓存 数据可视化 C#
WPF技术之Frame控件
WPF (Windows Presentation Foundation) Frame是WPF中的一个控件,它在应用程序中提供了一个容器,用于加载和显示其他页面或用户界面元素。
1954 0