首页 > 系统相关 >git diff与linux diff的输出格式之unified format

git diff与linux diff的输出格式之unified format

时间:2022-10-09 21:56:49浏览次数:70  
标签:输出 git format unified 格式 diff txt

git diff与linux diff的输出格式之unified format【转】 

 

前言

前面有一篇文章《一个有些意思的项目--文件夹对比工具(一)》,里面简单讲了下diff算法之--Myers算法。

既然是算法,就会有实现,比如git diff中有Myers的实现,git diff默认就是用了这个算法(也可以选择其他算法);这个Myers算法,在linux的diff工具中也有实现;或者在一些js库、java库等都有实现。

另外,既然是算法,那就有输入和输出,如果大家都正确实现的话,按理说输出格式也是能达成统一的。

接下来我们就看一下在各个软件中的输出格式。

git diff 输出格式

样例文件#

附原文件内容,有兴趣可以跟着试试。

image-20220803105718439

1111111111111111
2222222
333333333333333
4444444444444444444
55555555555
666666666
1111111111111111
2222222
333333333333333
4444444448878784444444444
insert1
55555555555
insert2
666666666
insert3

输出格式

之前我以为只能在版本间对比文件差异,原来文件也是可以直接对比的,如下:

git  diff  test.txt test2.txt

image-20220803105847584

这里可以看到,输出中还包含了一些两侧没变动的行,这是怎么回事呢?主要是,默认情况下,会输出差异行的上下文(即差异行的前面几行和后面几行,默认是三行)。

为了方便我们对比差异,我们先开启一个选项,不展示上下文。

-U

--unified=

Generate diffs with lines of context instead of the usual three. Implies --patch.

开启这个选项后,输出如下:

image-20220803110257944

我们看的里面有很多奇怪的符号,看得似懂非懂的,还有一些数字,也不知道啥意思,我们暂且不表,接下来,看看linux diff工具的输出。

linux diff输出格式

样例文件

同上。

输出格式(-U选项)

-U选项,在linux diff文档里,是这个意思,我们指定 -U 0,就是0行上下文。

   -u, -U NUM, --unified[=NUM]
          output NUM (default 3) lines of unified context

image-20220803110548048

看起来,格式差不太多哈,不过内容不太一样,这个先不用管,大家虽然都是同一个算法,但是部分工具会使用该算法的变体,所以输出有些不同也是正常。

先聚焦于输出格式即可。

默认输出格式(不带各类选项)

image-20220803111758903

看起来有点奇怪,输出都没有那些@@符号了,好像格式不同了,这是咋回事。

输出格式(-c选项)

其实还有个选项,如下:

   -c, -C NUM, --context[=NUM]
          output NUM (default 3) lines of copied context

这个看起来像是上下文之类的,我们测试下:

image-20220803112018690

看上去和默认格式、-U格式都不同。

linux diff输出的两种格式(官方文档)

具体内容都是来自于官方文档:https://www.gnu.org/software/diffutils/manual/html_node/index.html

image-20220803111438170

这里提到了两种格式:

  • Context Format,即-c选项时,这种对比文件时,感觉不是很直观;主要的场景是,用diff来生成代码补丁,代码差异行上下有上下文,方便补丁程序patch来进行差异代码定位。

    The context output format shows several lines of context around the lines that differ. It is the standard format for distributing updates to source code.

  • Unified Format,即-u选项时,这种对比文件时,感觉还比较方便看;官方定义如下:

    The unified output format is a variation on the context format that is more compact because it omits redundant context lines.

    即该格式是context format的变体,因为省略了冗余的上下文行,显得更加紧凑。

unified format格式

简介

不知道大家发现没,git diff和linux diff(-u)时,产生的格式是一样的,即unified format。

为什么单独讲这个格式呢,因为我发现,有很多文件差异相关的第三方库,不管是js、java啥的,产生的格式都是unified format。

而且,js中还有一个很广泛的库diff2html,是可以接收unified format格式的文件为输入,渲染为美观大方的html组件。

所以,在软件生态来说,该格式已经是一个相对通用的交互格式了,类似于json、xml这样的标准格式,所以,我们就讲解它。

详解

以如下输出来举例:

image-20220803114410981

unified format一开始就是文件列表,就是上图的:

--- a/test.txt
+++ b/test2.txt

接下来就是差异段列表了,上图一共两个差异段,有点看不懂?那我们再看看样例文件在beyond compare中的对比效果。

image-20220803105718439

以如下差异段来说:

@@ -4 +4,2 @@
-4444444444444444444
+4444444448878784444444444
+insert1

@@ 这一行,表示一个汇总信息,其中的-4,其实应该是-4,1。 "-"代表文件--- a/test.txt,4代表第四行,test.txt的第4行,就是4444444444444444444这一行,被省略的1,表示展示的text.txt从第4行开始的行的数量。

比如,4,2表示展示第4、5行,4,3表示展示第4、5、6行。

+4,2同理,"+"代表文件+++ a/test2.txt,也就是展示4开头的两行,即第4、5行。

大家再看看这个图,不知道是不是可以理解了:

image-20220803105718439

另外,@@是header行,算是一个汇总信息,就像是一个协议包的包头一样,说明包的内容的长度等,或者像是http里的content-length字段。

接下来,就是具体的内容,

@@ -4 +4,2 @@
-4444444444444444444
+4444444448878784444444444
+insert1

比如,-4444444444444444444的“-”不仅表示属于文件text.txt,还表示这行是要被删除的。“+”也是同理,表示是要新增的行。

还有一种情况是,两边行相等(比如需要展示上下文的时候),这种时候的话,前缀就是一个空字符,“ ”。

具体看下面:

https://www.gnu.org/software/diffutils/manual/html_node/Detailed-Unified.html

image-20220803115758775

扩展资料:

https://en.wikipedia.org/wiki/Diff#:~:text=The unified format (要会上网)

diff2html渲染unified format

之前提到unified format就是个中间格式,只要大家都按这个格式来,生态就建立起来了。

接下来,我们就把前面那个字符串用一个js库:diff2html来渲染一下,看看效果。

先在js中定义个字面量diffString,再用diff2html这个js库来渲染:

    const diffString = `--- a/test.txt
+++ b/test2.txt
@@ -4 +4,2 @@
-4444444444444444444
+4444444448878784444444444
+insert1
@@ -6 +7,3 @@
-666666666
\ No newline at end of file
+insert2
+666666666
+insert3`;


document.addEventListener('DOMContentLoaded', function () {
    const targetElement = document.getElementById('filesExistInBothDir');
    const configuration = {
        // 渲染文件列表
        drawFileList: true,
        // 文件列表显示/隐藏的开关
        fileListToggle: false,
        // 默认展示文件列表
        fileListStartVisible: false,
        // 文件内容可收起/展开的开关
        fileContentToggle: true,
        matching: 'lines',
        // 左右两侧双栏展示
        outputFormat: 'side-by-side',
        // 双栏展示模式时,拖动左边的横向滚动条,右侧同步滚动
        synchronisedScroll: true,
        // 高亮代码
        highlight: true,
        renderNothingWhenEmpty: true,
    };
    const diff2htmlUi = new Diff2HtmlUI(targetElement, diffString, configuration);
    diff2htmlUi.draw();
    diff2htmlUi.highlightCode();

效果如下:

image-20220803131800285

html源文件上传了,感兴趣可以看看:

https://dump-1252523945.cos.ap-shanghai.myqcloud.com/img/compare-result-162513.html

标签:输出,git,format,unified,格式,diff,txt
From: https://www.cnblogs.com/jyou/p/16773816.html

相关文章

  • 【小项目】微信定时推送天气预报Github项目使用及原理介绍-包含cron、天气预报、常用a
    一、资料链接1、github地址​​https://github.com/qq1534774766/wx-push​​2、教程地址3、易客云API(自动发送天气)​​https://yikeapi.com/account/index​​4、apispace-......
  • 【小项目】微信定时推送天气预报Github项目使用及原理介绍-包含cron、天气预报、常用a
    一、资料链接1、github地址​​https://github.com/qq1534774766/wx-push​​2、教程地址3、易客云API(自动发送天气)​​https://yikeapi.com/account/index​​4、apispace-......
  • Difference between array.GetLength(0) and array.GetUpperBound(0)
    Differencebetweenarray.GetLength(0)andarray.GetUpperBound(0)Whatisthedifferencebetweenthesetwomethodsandwhenwouldyouuseoneinsteadoftheot......
  • git的相关操作
    1.设置用户名和邮箱gitconfig--globaluser.name"小民"gitconfig--globaluser.email"[email protected]"2.查看一部分信息$gitconf......
  • Git常用命令
    Git全局设置安装完Git首先要做的事情就是设置用户名称和email地址,每次git提交都会使用该用户信息在git命令行执行下面命令:gitconfig--globaluser.name"superbaby"g......
  • git统计代码行数
    项目路径下打开gitbash执行命令gitlog--author="你的git登录名称"--pretty=tformat:--numstat|awk'{add+=$1;subs+=$2;loc+=$1-$2}END{printf"a......
  • Git代码托管服务
    常用的代码托管服务借助互联网上提供的一些代码托管服务来实现,比较常用的有GitHub,码云,GitLib等GitHub(https://github.com),是一个面向开源及私有软件的托管平台,只支......
  • Git概述
    Git简介Git是一个分布式版本控制工具,通常用来对软件开发过程中的源代码文件进行管理。Git仓库分为两种:本地仓库:开发人员自己电脑上的Git仓库。远程仓库:远程服务器上的......
  • 手把手教你玩转 Gitea|在 Windows 系统上安装 Gitea
    Gitea支持在Windows系统上安装和使用。Gitea本身作为一个单体应用程序,即点即用,如需长期驻留作为后台服务并开机运行就要依靠Windows服务工具sc.exe。通过本文,你将......
  • git 操作记录
    gitpull拉去线上的。gitbranch查看当前分支gitbranch-r查看远程分支gitcheckout[分支名称]切换到某个分支gitpush​​​http://www.open-open.com/lib/vi......