Setup and Config
Getting and Creating Projects
Basic Snapshotting
Branching and Merging
Sharing and Updating Projects
Inspection and Comparison
Patching
Debugging
External Systems
Server Admin
Guides
- gitattributes
- Command-line interface conventions
- Everyday Git
- Frequently Asked Questions (FAQ)
- Glossary
- Hooks
- gitignore
- gitmodules
- Revisions
- Submodules
- Tutorial
- Workflows
- All guides...
Administration
Plumbing Commands
- 2.46.1 → 2.46.2 no changes
- 2.46.0 07/29/24
- 2.45.1 → 2.45.2 no changes
- 2.45.0 04/29/24
- 2.44.1 → 2.44.2 no changes
- 2.44.0 02/23/24
- 2.43.1 → 2.43.5 no changes
- 2.43.0 11/20/23
- 2.42.2 → 2.42.3 no changes
- 2.42.1 11/02/23
- 2.42.0 08/21/23
- 2.41.1 → 2.41.2 no changes
- 2.41.0 06/01/23
- 2.40.1 → 2.40.3 no changes
- 2.40.0 03/12/23
- 2.36.1 → 2.39.5 no changes
- 2.36.0 04/18/22
- 2.35.1 → 2.35.8 no changes
- 2.35.0 01/24/22
- 2.33.3 → 2.34.8 no changes
- 2.33.2 03/23/22
- 2.33.1 10/12/21
- 2.33.0 08/16/21
- 2.32.1 → 2.32.7 no changes
- 2.32.0 06/06/21
- 2.31.1 → 2.31.8 no changes
- 2.31.0 03/15/21
- 2.30.1 → 2.30.9 no changes
- 2.30.0 12/27/20
- 2.29.1 → 2.29.3 no changes
- 2.29.0 10/19/20
- 2.28.1 no changes
- 2.28.0 07/27/20
- 2.27.1 no changes
- 2.27.0 06/01/20
- 2.26.1 → 2.26.3 no changes
- 2.26.0 03/22/20
- 2.25.2 → 2.25.5 no changes
- 2.25.1 02/17/20
- 2.25.0 01/13/20
- 2.24.1 → 2.24.4 no changes
- 2.24.0 11/04/19
- 2.22.1 → 2.23.4 no changes
- 2.22.0 06/07/19
- 2.21.1 → 2.21.4 no changes
- 2.21.0 02/24/19
- 2.20.1 → 2.20.5 no changes
- 2.20.0 12/09/18
- 2.19.1 → 2.19.6 no changes
- 2.19.0 09/10/18
- 2.18.1 → 2.18.5 no changes
- 2.18.0 06/21/18
- 2.17.1 → 2.17.6 no changes
- 2.17.0 04/02/18
- 2.16.6 12/06/19
- 2.15.4 12/06/19
- 2.14.6 12/06/19
- 2.13.7 05/22/18
- 2.12.5 09/22/17
- 2.11.4 09/22/17
- 2.10.5 09/22/17
- 2.9.5 07/30/17
- 2.8.6 07/30/17
- 2.7.6 no changes
- 2.6.7 05/05/17
- 2.5.6 05/05/17
- 2.4.12 05/05/17
- 2.3.10 no changes
- 2.2.3 09/04/15
- 2.1.4 12/17/14
- 2.0.5 12/17/14
描述
显示一个或多个对象(Blobs、树、标签和提交)。
对于提交,它显示日志信息和文本差异。并会以一种特殊的格式显示合并提交,就像 git diff-tree --cc 所产生的信息那样。
对于标签,它显示标签信息和引用的对象。
对于目录树,它显示名字(相当于 git ls-tree 添加了 --name-only 选项)。
对于普通二进制对象,它显示普通内容。
git log 命令理解的一些选项可以用来控制如何显示提交带来的改动。
本手册页只描述了最常用的选项。
选项
- <对象>…
-
要显示的对象的名称(默认为’HEAD')。 更完整的对象名称拼写方式列表,请参见 gitrevisions[7] 中的 "特别修订" 部分。
- --pretty[=<格式>]
- --format=<格式>
-
以指定的格式打印提交日志的内容,其中'<format>'可以是’oneline'、short、medium、full、fuller、reference、email、raw、format:<string>'和’tformat:<string>'之一。 当<format>'不是上述任何一种,并且其中有'%placeholder’时,它的作用就像给出'--pretty=tformat:<format>'一样。
参见 "PRETTY FORMATS "部分,了解每种格式的一些额外细节。 当'=<格式>'部分被省略时,它默认为’中等'。
注意:你可以在版本库配置中指定默认的漂亮格式(见git-config[1])。
- --abbrev-commit
-
不要显示完整的40字节的十六进制提交对象名称,而是显示一个前缀,以唯一的方式命名该对象。 "--abbrev=<n>"选项可以用来指定前缀的最小长度(如果显示的话,它也会修改diff输出)。
这应该使"--pretty=oneline "对于使用80列终端的人来说更容易阅读。
- --no-abbrev-commit
-
显示完整的40字节十六进制的提交对象名称。这否定了`--abbrev-commit`,无论是明确的还是由其他选项如"--oneline "暗示的。它还覆盖了`log.abbrevCommit`变量。
- --oneline
-
这是"--pretty=oneline --abbrev-commit "的简写,一起使用。
- --encoding=<编码>
-
提交对象会在其编码头中记录日志信息使用的字符编码;该选项可用于告诉命令以用户偏好的编码重新编码提交日志信息。 对于非底层命令,默认编码为 UTF-8。需要注意的是,如果对象声称以
X
编码,而我们以X
输出,我们将逐字输出该对象;这意味着原始提交中的无效序列可能会被复制到输出中。同样,如果 iconv(3) 无法转换提交,我们也会静静地逐字输出原始对象。 - --expand-tabs=<n>
- --expand-tabs
- --no-expand-tabs
-
在输出中显示之前,在日志信息中进行标签扩展(用足够的空格替换每个标签,以填充到下一个显示列的 <n> 的倍数)。
--expand-tabs
是--expand-tabs=8
的简写,--no-expand-tabs
是--expand-tabs=0
的简写,它禁止标签扩展。默认情况下,标签会以漂亮的格式展开,将日志信息缩进4个空格(即 "中",这是默认的,"全",和 "更全")。
- --notes[=<引用>]
-
在显示提交日志信息时,显示注释提交的说明(见git-notes[1])。 这是`git log`、
git show`和`git whatchanged`命令的默认设置,当命令行中没有给出
--pretty`、--format`或
--oneline`选项时。默认情况下,显示的注释来自于`core.notesRef`和`notes.displayRef`变量(或相应的环境覆盖)中列出的注释参考。更多细节见git-config[1]。
有了一个可选的 <引用> 参数,就可以使用引用来寻找要显示的笔记。 当引用以
refs/notes/
开头时,可以指定完整的引用名称;当它以notes/
开头时,refs/
,否则refs/notes/
前缀,形成引用的全名。多个—音符选项可以组合起来,控制哪些音符被显示。例如。"--notes=foo "将只显示来自 "refs/notes/foo "的注释;"--notes=foo --notes "将同时显示来自 "refs/notes/foo "和默认注释的注释。
- --no-notes
-
不显示注释。这否定了上面的`--notes`选项,因为它重新设置了显示注释的注释列表。 选项按照命令行给出的顺序进行解析,因此,例如"--notes --notes=foo --no-notes --notes=bar "将只显示来自 "refs/notes/bar "的注释。
- --show-notes-by-default
-
显示默认备注,除非给出了显示特定备注的选项。
- --show-notes[=<引用>]
- --[no-]standard-notes
-
这些选项已被废弃。请使用上面的 --notes/--no-notes 选项来代替。
- --show-signature
-
通过将签名传递给
gpg --verify
来检查已签名的提交对象的有效性,并显示输出。
漂亮的格式
如果提交是一个合并,并且如果pretty-format不是 "oneline"、"email "或 "raw",那么在 "Author: "一行之前会插入一个附加行。 这一行的开头是 "Merge:这一行以 "Merge: "开头,并打印出祖先提交的哈希值,用空格分隔。 请注意,如果你限制了你的历史视图,那么列出的提交不一定是*直接*父级提交的列表:例如,如果你只对与某个目录或文件有关的修改感兴趣。
有几种内置的格式,你可以通过将 pretty.<名称> 配置选项设置为另一种格式名称或 format: 字符串来定义额外的格式,如下所述(见 git-config[1] )。下面是内置格式的细节:
-
oneline
<哈希值> <标题行>
这个设计是为了尽可能的紧凑。
-
short
承诺<hash> 作者。<作者>的情况
<标题行>
-
medium
commit <哈希值> Author: <作者> Date: <提交日期>
<标题行>
<完整的提交信息
-
full
承诺<hash> 作者。< Author> 承诺。<committer>(提交者)。
<标题行>
<完整的提交信息
-
fuller
commit <哈希值> Author: <作者> AuthorDate: <作者提交日期> Commit: <提交者> CommitDate: <提交者提交日期>
<标题行>
<完整的提交信息
-
‘引用’
<缩写哈希值>(<标题行>,<简短的作者日期>)
这种格式用于在提交信息中引用另一个提交,与`--pretty='format:%C(auto)%h (%s, %ad)'相同。 默认情况下,日期的格式为`--date=short`,除非明确指定其他`--date`选项。 与任何带有格式占位符的`format:
一样,其输出不受其他选项的影响,如
--decorate`和`--walk-reflogs`。 -
email
From <哈希> <日期> From: <作者> Date: <作者提交日期> Subject: [PATCH] <标题行>
<完整的提交信息
-
mboxrd
和 "email "一样,但提交信息中以 "From "开头的行(前面有零个或多个">")用">"引出,这样就不会被混淆为开始了一个新的提交。
-
raw
原始 "格式显示的是整个提交对象中存储的内容。 值得注意的是,无论是否使用了 --abbrev 或 --no-abbrev,哈希值都会被完整地显示出来,而’parent’信息会显示真正的父级提交,不会考虑移花接木或历史简化。注意,这种格式会影响提交的显示方式,但不会影响diff的显示方式,比如用`git log --raw`来显示。要获得原始差异格式的完整对象名称,请使用`--no-abbrev`。
-
format:<格式字符串>
format:<格式字符串 格式允许你指定要显示的信息。它的工作原理有点像 printf 格式,但有一个明显的例外,那就是换行符是 %n 而不是 \n。
例如,format: "The author of %h was %an, %ar%nThe title was >>%s<<%n" 会显示这样的内容:
fe6e0ee的作者是Junio C Hamano, 23小时前 标题是 >>t4119: 测试传统diff输入的自动计算-p<n>。
占位符是:
-
占位符,可扩展为一个字面字符:
-
影响后面占位符的格式化的占位符:
- %Cred
-
切换颜色为红色
- %Cgreen
-
切换颜色为绿色
- %Cblue
-
将颜色改为蓝色
- %Creset
-
重置颜色
- %C(…)
-
颜色规范,如git-config[1]的 "配置文件 "部分中的数值描述。 默认情况下,只有在启用日志输出时才会显示颜色(通过
color.diff
,color.ui
, 或--color
, 如果我们要去终端,要尊重前者的`auto`设置)。%C(auto,...)`被接受为默认的历史同义词(例如,
%C(auto,red))。指定
%C(always,…)将显示颜色,即使没有启用颜色(尽管考虑使用
--color=always`来启用整个输出的颜色,包括这个格式和其他任何git可能的颜色)。auto`单独使用(即
%C(auto)`)将在下一个占位符上开启自动着色,直到再次切换颜色。 - %m
-
左(
<
)、右(>
)或边界(-
)标记 - %w([<w>[,<i1>[,<i2>]]])
-
开关包行,就像 git-shortlog[1] 的 -w 选项。
- %<(<N>[,trunc|ltrunc|mtrunc])
-
使下一个占位符至少占用 N 列宽,必要时在右侧填充空格。 如果输出超过 N 列,可选择在左侧(ltrunc)
..ft
、中间(mtrunc)mi..le
或末尾(trunc)rig..
截断(用省略号 .. )。 注意 1:截断只在 N >= 2 时有效。 注 2:N 和 M(见下文)值周围的空格为可选项。 注 3:表情符号和其他宽字符将占用两个显示列,可能会超出列边界。 注 4:分解字符组合标记可能会在填充边界处错位。 - %<|(<M>)
-
使下一个占位符至少显示到第 M 列,必要时在右侧填充空格。 从终端窗口右侧边缘测量的列位置使用负 M 值。
- %>(<N>), %>|(<M>)
-
分别类似于 %<( <N> ) 、%<|( <M> ),但在左侧填充空格
- %>>(<N>), %>>|(<M>)
-
分别类似于'%>(<N>)、%>|(<M>)',只是如果下一个占位符占用的空间比给定的多,并且其左侧有空格,则使用这些空格
- %><(<N>), %><|(<M>)
-
分别类似于'%<( <N> )' 和 %<|( <M> ),但两边都有填充(即文本居中)
-
占位符,扩展到从提交中提取的信息:
- %H
-
提交的哈希值
- %h
-
简称提交哈希
- %T
-
目录树哈希值
- %t
-
简称树形哈希
- %P
-
父类哈希值
- %p
-
缩写的父母哈希值
- %an
-
作者名
- %aN
-
作者名(关于 .mailmap,请参见 git-shortlog[1] 或 git-blame[1]
- %ae
-
作者电子邮箱
- %aE
-
作者电子邮件(关于 .mailmap,请参见 git-shortlog[1] 或 git-blame[1]
- %al
-
作者电子邮件的本地部分(@ 符号之前的部分)
- %aL
-
尊重 .mailmap 作者的本地部分(参见 %al ),参见 git-shortlog[1] 或 git-blame[1])
- %ad
-
作者日期(格式尊重—date=选项
- %aD
-
作者日期,RFC2822风格
- %ar
-
作者日期,相对
- %at
-
作者日期,UNIX时间戳
- %ai
-
作者日期,类似ISO 8601的格式
- %aI
-
作者日期,严格的ISO 8601格式
- %as
-
作者日期,短格式(
YYYY-MM-DD
) - %ah
-
作者日期,以易读形式呈现(就像 git-rev-list[1] 的
--date=human
选项) - %cn
-
提交者名称
- %cN
-
提交者名称(尊重 .mailmap,参见 git-shortlog[1] 或 git-blame[1]
- %ce
-
提交者电子邮箱
- %cE
-
提交者电子邮箱(尊重 .mailmap,参见 git-shortlog[1] 或 git-blame[1]
- %cl
-
提交者电子邮件的本地部分(@ 符号之前的部分)
- %cL
-
提交者本地部分(参见'%cl' )尊重 .mailmap, 参见 git-shortlog[1] 或 git-blame[1])
- %cd
-
承诺人日期(格式尊重—date=选项
- %cD
-
承诺人日期,RFC2822风格
- %cr
-
承诺人日期,相对
- %ct
-
提交者日期,UNIX时间戳
- %ci
-
承诺人日期,类似ISO 8601的格式
- %cI
-
承诺人日期,严格的ISO 8601格式
- %cs
-
承诺人日期,短格式(
YYYY-MM-DD
) - %ch
-
提交者的日期,人类风格(就像 git-rev-list[1] 的
--date=human
选项) - %d
-
ref名称,就像git-log[1]的—decorate选项。
- %D
-
没有"("、")"包装的参考文献名称。
- %(decorate[:<选项>])
-
自定义装饰的引用名称。
decorate
字符串后面可以是冒号和零个或多个以逗号分隔的选项。选项值可能包含字面格式化代码。由于逗号(%x2C
)和结尾括号(%x29
)在选项语法中的作用,因此必须使用这些代码。-
prefix=<值>: 显示在引用名称列表之前。 默认为 "
(
"。 -
suffix=<值>: 显示在引用名称列表之后。 默认为 "
)
"。 -
separator=<值>: 显示在引用名称之间。 默认为 "
,
"。 -
point=<值>: 显示在 HEAD 和其指向的分支(如果有)之间。 默认为 "
->
"。 -
tag=<值>: 显示在标记名称之前。默认为 "
tag:
"。
-
例如,制作不带包装或标签注释的装饰,并用空格作为分隔符:
+
%(decorate:prefix=,suffix=,tag=,separator= )
- %(describe[:<选项>])
-
人类可读的名字,像git-describe[1];空字符串表示不可描述的提交。 `describe`字符串后面可以有冒号和零个或多个逗号分隔的选项。 当标签同时被添加或删除时,描述可能不一致。
-
tags[=<bool-value>]:不仅考虑带注释的标签,还考虑轻量级标签。
-
abbrev=<数量>:不使用缩写对象名称的默认十六进制位数(根据仓库中对象的数量而变化,默认为 7 位),而是使用 <数量> 的位数,或根据需要的位数来组成唯一的对象名称。
-
match=<pattern>:只考虑与给定的`glob(7)`模式匹配的标签,不包括 "refs/tags/"前缀。
-
exclude=<pattern>:不考虑匹配给定`glob(7)`模式的标签,排除 "refs/tags/"前缀。
-
- %S
-
在命令行中给出的提交名称(如
git log --source
),只对git log
起作用 - %e
-
编码方式
- %s
-
主题
- %f
-
经过消毒的主题行,适合于文件名
- %b
-
正文
- %B
-
原始体(未包装的主题和体)
- %N
-
承诺说明
- %GG
-
来自GPG的签名提交的原始验证信息
- %G?
-
显示 "G" 代表一个好的(有效的)签名,"B" 代表一个坏的签名,"U" 代表一个有效性未知的好的签名,"X" 代表一个已经过期的好的签名,"Y" 代表一个由过期的钥匙制作的好的签名,"R" 代表一个由撤销的 钥匙制作的好的签名,"E" 如果不能检查签名(如缺少钥匙),"N" 代表没有签名
- %GS
-
显示已签名的提交的签名者的名字
- %GK
-
显示用于签署已签名的承诺的密钥
- %GF
-
显示用于签署已签名提交文件的密钥的指纹
- %GP
-
显示主键的指纹,该主键的子键被用来签署一个已签署的提交
- %GT
-
显示用于签署已签名的承诺的密钥的信任级别
- %gD
-
reflog选择器,例如,
refs/stash@{1}`或`refs/stash@{2分钟前}
;其格式遵循`-g`选项的规则。@'前面的部分是命令行上给出的参考文献名称(所以`git log -g refs/heads/master`会产生`refs/heads/master@{0}
)。 - %gd
-
简化的 reflog 选择器;与
%gD
相同,但 refname 部分被缩短以利于人类阅读(因此refs/heads/master
变成了master
)。 - %gn
-
记录身份名称
- %gN
-
引用日志身份名称(尊重 .mailmap,参见 git-shortlog[1] 或 git-blame[1]
- %ge
-
重新记录身份邮件
- %gE
-
引用日志身份电子邮箱(尊重 .mailmap,参见 git-shortlog[1] 或 git-blame[1]
- %gs
-
记录主题
- %(trailers[:<选项>])
-
显示由 git-interpret-trailers[1] 解释的正文的为主。
trailers
字符串后面可以有冒号和零个或多个逗号分隔的选项。 如果任何选项被多次提供,则最后出现的选项获胜。-
key=<键>:只显示具有指定密钥的为主。匹配是不分大小写的,后面的冒号是可选的。如果多次给出选项,则显示与任何键匹配的为主行。该选项自动启用
only
选项,使拖车块中的非尾注行被隐藏。如果不希望这样,可以用only=false
禁用。 例如,%(trailers:key=Reviewed-by)
显示键为Reviewed-by
的拖车行。 -
only[=<布尔值>] :选择是否应该包括来自尾注块的非尾注行。
-
separator=<sep>: specify the separator inserted between trailer lines. Defaults to a line feed character. The string <sep> may contain the literal formatting codes described above. To use comma as separator one must use
%x2C
as it would otherwise be parsed as next option. E.g.,%(trailers:key=Ticket,separator=%x2C )
shows all trailer lines whose key is "Ticket" separated by a comma and a space. -
unfold[=<布尔值>]:使它的行为就像 interpret-trailer 的
--unfold
选项被给出一样。例如,`%(trailers:only,unfold=true)`会展开并显示所有的尾注行。 -
keyonly[=<布尔值>]:只显示尾注的关键部分。
-
valueonly[=<布尔值>]:只显示尾注的值部分。
-
key_value_separator=<sep>: specify the separator inserted between the key and value of each trailer. Defaults to ": ". Otherwise it shares the same semantics as separator=<sep> above.
-
-
Note
|
一些占位符可能取决于给修订版遍历引擎的其他选项。例如,%g* reflog选项将插入一个空字符串,除非我们正在遍历reflog条目(例如,通过`git log -g`)。%d`和 %D`占位符将使用 "短 "装饰格式,如果`--decorate`没有在命令行上提供。
|
布尔选项接受一个可选的值`[=<布尔值>]。`true
, false
, on
, `off`等值都可以接受。参见git-config[1]中 “示例” 的 “布尔” 子章节。如果一个布尔选项没有给出值,它就被启用。
如果你在占位符的'%后面加了一个`+(加号),当且仅当占位符扩展为一个非空字符串时,在扩展前会立即插入换行符。
如果你在占位符的'%后面加了一个`-(减号),如果且仅当占位符扩展为空字符串时,紧接着扩展前的所有连续换行将被删除。
如果你在占位符的'%'后面加了一个``(空格),当且仅当占位符扩展到一个非空字符串时,空格就会紧接着插入扩展。
-
t格式:
tformat: 格式的工作原理与 format: 完全一样,只是它提供了 “终止符” 语义,而不是 “分隔符” 语义。换句话说,每个提交都附加了信息结束符(通常是换行符),而不是在条目之间放置一个分隔符。 这意味着单行格式的最后一个条目将正确地以新行结束,就像 “单行” 格式那样。 比如说:
$ git log -2 --pretty=format:%h 4da45bef \ | perl -pe '$_ .= " -- NO NEWLINE\n" unless /\n/' 4da45be 7134973 -- NO NEWLINE $ git log -2 --pretty=tformat:%h 4da45bef \ | perl -pe '$_ .= " -- NO NEWLINE\n" unless /\n/' 4da45be 7134973
此外,任何未被识别的字符串,如果其中有
%
,将被解释为前面有tformat:
。 例如,这两个是等同的:$ git log -2 --pretty=tformat:%h 4da45bef $ git log -2 --pretty=%h 4da45bef
差异格式化
下面的选项可以用来改变`git show`生成差异输出的方式。
- -p
- -u
- --patch
-
生成补丁(请参阅 使用选项
-p
生成补丁文本 )。 - -s
- --no-patch
-
抑制差异(diff)工具的所有输出。 对于默认显示补丁的
git show
等命令,可以压制其输出,或在别名中取消命令行中的--patch
、--stat
等选项的效果。 - -m
-
以默认格式显示合并提交的差异。这与 --diff-merges=on 类似,但除非同时给出
-p
,否则-m
不会产生任何输出。 - -c
-
生成合并提交的合并差异输出。 --diff-merges=combined -p 的快捷方式。
- --cc
-
生成合并提交的密集合并差异输出。 --diff-merges=dense-combined -p 的快捷方式。
- --dd
-
为合并提交和常规提交生成与第一父提交的差异。 --diff-merges=first-parent -p 的快捷方式。
- --remerge-diff
-
生成合并提交的 remerge-diff 输出。 --diff-merges=remerge -p 的快捷方式。
- --no-diff-merges
-
--diff-merges=off 的同义词。
- --diff-merges=<格式>
-
指定合并提交时使用的差异格式。默认为 `dense-combined`,但当使用
--first-parent
选项时,默认为first-parent
。支持以下格式:
- off, none
-
禁用合并提交时的差异输出。对覆盖隐含值很有用。
- on, m
-
该选项使合并提交的差异输出以默认格式显示。
-m
只有在-p
的情况下才会产生输出。默认格式可以通过log.diffMerges
配置参数改变,默认值为separate
。 - first-parent, 1
-
显示与第一个父提交的完整差异。这与
--patch
为非合并提交生成的格式相同。 - separate
-
显示每个父代的完整差异。 每个父代都会生成单独的日志条目和差异。
- combined, c
-
同时显示每个父文件与合并结果之间的差异,而不是逐个显示父文件与合并结果之间的成对差异。此外,它只列出从所有父文件修改过的文件。
- dense-combined, cc
-
使用该选项,通过省略不感兴趣的块,进一步压缩
--diff-merges=combined
产生的输出,这类块在父提交中的内容只有两个变体,并且合并结果选择了其中一个而没有修改。--cc
选项暗含-p
。 - remerge, r
-
重合双亲合并提交以创建临时目录树对象——可能包含冲突标记等文件。 然后会显示临时目录树与实际合并提交之间的差异。
使用该选项时发出的输出是可以改变的,它与其他选项的互动也是可以改变的(除非有明确的记录)。
- --combined-all-paths
-
这个标志会使合并后的差异文件(用于合并提交)列出所有父提交的名称。,因此它只在使用
--diff-merges=[dense-]combined
时有效。其可能在检测到文件名变化时有用(例如,当要求检测重命名或复制时)。 - -U<n>
- --unified=<n>
-
生成带有 <n> 行上下文的差异,而不是通常的 3 行。暗含
--patch
选项。 暗含--patch
选项。 - --output=<文件>
-
输出到一个特定的文件,而不是标准输出。
- --output-indicator-new=<字符>
- --output-indicator-old=<字符>
- --output-indicator-context=<字符>
-
指定在生成的补丁中用来表示新、旧或上下文行的字符。通常它们分别是 +、- 和 ' '(空格)。
- --raw
-
对于每一个提交,使用原始的差异格式 请参见 git-diff[1] 中 “原始输出格式” 一节 。 这与显示日志中的本身的原始格式不同 你可以用
--format=raw
来实现。 - --patch-with-raw
-
-p--raw
的同义词。 - -t
-
在差异输出中显示目录树对象。
- --indent-heuristic
-
启用启发式的缩进区块的方法,使得补丁更易读。这是默认选项。
- --no-indent-heuristic
-
禁用启发式缩进。
- --minimal
-
花费额外的时间以确保生成尽可能小的差异。
- --patience
-
使用 "patience diff" 算法生成差异。
- --histogram
-
使用 "histogram diff" 算法生成差异。
- --anchored=<文本>
-
使用 "anchored diff" 算法生成差异。
这个选项可以被指定多次。
如果某一个行同时存在于来源和目标中,各只出现一次,以这个文本开头,这个算法试图防止它在输出中以删除或添加的形式出现。它在内部使用了 "patience diff" 算法。
- --diff-algorithm={patience|minimal|histogram|myers}
-
选择差异算法。有如下可选项:
例如,如果你将
diff.algorithm
变量配置为非默认值,但希望使用默认值,那么你必须使用--diff-algorithm=default
选项。 - --stat[=<宽度>[,<名称宽度>[,<数值>]]]
-
生成差异统计(diffstat)。默认情况下,文件名部分将使用尽可能多的空间,其余空间用于图表部分。最大宽度默认为终端宽度,如果未连接终端,则为 80 列,可以用
<最大宽度>`覆盖。文件名部分的宽度可以通过在逗号后另加宽度 `<文件名宽度>`或设置 `diff.statNameWidth=<文件名宽度>`来限制。图形部分的宽度可以通过使用 `--stat-graph-width=<图形宽度>`或设置 `diff.statGraphWidth=<图像宽度>
来限制。使用--stat
或--stat-graph-width
选项会影响所有生成统计图的命令,而设置diff.statNameWidth
或diff.statGraphWidth
则不会影响git format-patch
。 通过给出第三个参数<行数>
,可以将输出限制在前<行数>`行,如果行数更多,则在后面加上 `...
。这些参数也可以用
--stat-width=<宽度>
,--stat-name-width=<名称宽度>
和--stat-count=<数量>
单独设置。 - --compact-summary
-
在差异状态中输出扩展头信息的压缩摘要,如文件的创建或删除("new" 或 "good"。如果是符号链接,则为 "+l")和模式变化("+x" 或 "-x" 分别用于添加或删除可执行位)。这些信息被放在文件名部分和图形部分之间。暗含
--stat
选项。 - --numstat
-
类似于
--stat
,但是使用小数点和不含缩写的路径名显示添加和删除的行数,使其对程序更友好。对于二进制文件,输出两个-
,而不是0 0
。 - --shortstat
-
只输出使用
--stat
选项输出的最后一行,包含修改的文件总数,添加和删除的行数。 - -X[<参数1,参数2,…>]
- --dirstat[=<参数1,参数2,…>]
-
输出每个子目录的相对变化量的分布。
--dirstat
的行为可以通过传递一个以逗号分隔的参数列表来自定义。默认值由`diff.dirstat` 配置变量控制 (参见 git-config[1])。以下是可用的参数:-
changes
-
通过计算从源文件中删除的行数或添加到目标文件中的行数来计算分布状态的数字。这忽略了文件内的代码移动行为。也就是说,在文件中重新排列的行不会像其他变化一样被计算在内。这是在没有给出参数时的默认行为。
-
lines
-
通过做常规基于行的差异分析,计算分布状态的数字,并将删除/添加的行数相加。(对于二进制文件,用 64 字节的块来计算,因为二进制文件没有行的概念)。在使用
--dirstat
时这个选项的行为开销比changes
更大,但会对文件中重新排列的行进行计数。其得到的输出结果与其他的--*stat
选项一致。 -
files
-
通过计算被改变的文件数量来计算分布状态的数字。在分布状态分析中,每一个被改变的文件都会被平等地计算。这是计算上开销最小的
--dirstat
行为,因为它无需查看文件内容。 -
cumulative
-
子目录中的变化计算到父目录中。 注意,当使用
cumulative
选项时,报告的百分比之和可能超过 100%。默认的(非累积)行为可以用noncumulative
参数指定。 - <limit>
-
一个整数参数,其指定一个截止百分比(默认为 3%)。贡献值小于这个百分比的目录不显示在输出中。
例如:下面的参数会统计更改的文件,同时忽略占更改文件总数 10% 以下的目录,并累积父目录中的子目录计数:
--dirstat=files,10,cumulative
。 -
- --cumulative
-
--dirstat=cumulative 同义
- --dirstat-by-file[=<参数1,参数2>…]
-
与 --dirstat=files,<参数 1>,<参数 2> 同义
- --summary
-
输出扩展头信息,如创建、重命名和模式变化等,的压缩摘要。
- --patch-with-stat
-
同义词
-p --stat
。 - -z
-
用 NUL 而不是用换行来分隔提交。
另外,当给出
--raw
或--numstat
时,不合并路径名,并使用 NUL 作为输出字段终止符。如果没有这个选项,带 “不常见” 字符的路径名会被引用,正如配置变量
core.quotePath
所解释的那样(参见 git-config[1])。 - --name-only
-
Show only the name of each changed file in the post-image tree. The file names are often encoded in UTF-8. For more information see the discussion about encoding in the git-log[1] manual page.
- --name-status
-
Show only the name(s) and status of each changed file. See the description of the
--diff-filter
option on what the status letters mean. Just like--name-only
the file names are often encoded in UTF-8. - --submodule[=<格式>]
-
指定子模块中的差异如何显示。当指定
--submodule=short
选项时,会使用 short 格式。这种格式只显示范围的开头和结尾处的提交名称。当指定了--submodule
或--submodule=log
时,会使用 log 格式。这种格式会像 git-submodule[1]summary
那样,列出该范围内的提交。当指定了--submodule=diff
时,会使用 diff 格式。这个格式显示的是子模块内在提交范围之间的变化差异。默认为diff.submodule
,如果配置选项未设置, 则为short
格式。 - --color[=<when>]
-
显示有颜色的差异。
--color
(即不含 =<何时>)与--color=always
相同。<何时> 可以是always
、never
或auto
。 - --no-color
-
关掉带彩色显示的差异。 这和
--color=never
相同。 - --color-moved[=<模式>]
-
移动的代码行的颜色不同。 如果没有给出该选项,<模式> 默认为 no 如果没有给定模式选项,则为 zebra。 该模式必须以下其中之一:
- no
-
被移动的行不突出显示。
- default
-
是
zebra
的同义词。今后可能会改成更合理的模式。 - plain
-
任何在某个位置被添加,且在另一个位置被删除的行,都会被用 color.diff.newMoved 着色。同样的,在差异中在某处删除且在其它地方添加的行会使用 color.diff.oldMoved 着色。这种模式可以读取任何被移动的行,但在代码审查中,它不能确定一个代码块是否未经排列而进行了移动。
- blocks
-
使用贪心方法检测含至少 20 个字母数字字符的移动文本块。检测到的区块使用 color.diff.{old,new}Moved 的颜色。相邻的区块不能被区分开。
- zebra
-
在 ‘块’ 模式下检测到移动的文本块。块使用 color.diff.{old,new}Moved 颜色或 color.diff.{old,new}MovedAlternative 颜色。这两种颜色之间的变化表示检测到了新的块。
- dimmed-zebra
-
类似于 zebra 模式,但对使移动的代码中不关注的部分变暗。相邻两个区块的边界线被认为是重要,其余的部分是无关紧要的。
dimmed_zebra
是一个被废弃的同义词。
- --no-color-moved
-
关闭移动检测。这可以用来覆盖配置设置。它与
--color-moved=no
相同。 - --color-moved-ws=<模式>
-
这将配置在执行
--color-moved
选项的移动检测时如何忽略空格。 这些模式可以通过以逗号分隔的列表给出: - --no-color-moved-ws
-
执行移动检测时,不忽略空格。这可以用来覆盖配置。它与
--color-moved-ws=no
相同。 - --word-diff[=<模式>]
-
显示词的差异,用 <模式> 来分隔已更改的词。默认情况下,单词是以空格分隔;请参考
--word-diff-regex
。<模式> 默认为plain
,并且必须是以下其中之一:请注意,无论第一个模式的名称是什么,如果启用该选项,将在所有模式中使用颜色,以高亮显示更改的部分。
- --word-diff-regex=<正则表达式>
-
使用 <正则表达式> 来确定单词的格式,而不是将一串非空白行视为单词。除非已启用,否则还暗含
--word-diff
选项。<正则表达式> 匹配的的每一个非重叠的匹配都被视为一个单词。在这些匹配项之间的任何内容都被认为是空白,并且在查找差异时被忽略(!)。您可能需要在您的正则表达式中附加
|[^[:space:]]
,以确保它匹配所有非空格字符。包含换行的匹配会在换行处被截断(!)。例如,
--word-diff-regex=.
将把每个字符当作一个单词,并相应地逐个字符显示差异。正则表达式也可以通过差异程序或配置选项来设置,参见 gitattributes[5] 或 git-config[1]。显式指明会覆盖任何程序或配置。差异程序会覆盖配置。
- --color-words[=<正则表达式>]
-
与
--word-diff=color
和(如果指明了正则表达式)--word-diff-regex=<正则表达式>
两个选项含义相同。 - --no-renames
-
关闭重命名检测,即使配置文件给出的默认是这样做。
- --[no-]rename-empty
-
是否使用空的数据对象作为重命名源。
- --check
-
如果更改引入冲突标记或空格错误,则发出警告。哪些被认为是空格错误是由
core.whitespace
配置控制的。默认情况下,行尾部的空格字符(包括仅由空格字符组成的行)和紧跟在行初缩进内 tab 字符后的空格字符,都被认为是空格字符错误。如果发现问题,则以非零状态退出。与 --exit-code 选项不兼容。 - --ws-error-highlight=<种类>
-
突出显示差异中
context
(上下文)、old
(旧)或new
(新)行中的空格错误。多个值用逗号隔开,none
选项会重置以前的值,default
重置列表为new
,all
是old,new,context
的简写。当没有给定这个选项,并且配置变量diff.wsErrorHighlight
没有设置时,只有new
行中的空格错误会被高亮显示。空格错误会用color.diff.whitespace
配置进行着色。 - --full-index
-
在生成补丁格式输出时,在
index
(索引)行上显示完整的图像前和图像后数据对象名称,而不仅是前几个字符。 - --binary
-
除了
--full-index
输出的差异之外,输出二进制的差异。其可以用git-apply
命令来应用。暗含--patch
选项。 暗含--patch
选项。 - --abbrev[=<n>]
-
在 diff-raw 格式输出和 diff-tree 头文件行中,不显示完整的 40 字节十六进制对象名称,而是显示唯一指向对象的最短前缀,长度至少为 <n> 位十六进制数字。 在 diff-patch 输出格式中,
--full-index
优先,也就是说,如果指定了--full-index
,则无论--abbrev
如何,都会显示完整的 blob 名称。 可以使用--abbrev=<n>
指定非默认位数。 - -B[<n>][/<m>]
- --break-rewrites[=[<n>][/<m>]]
-
将完整的重写更改切分成删除和创建对(pair)。这有两个目的:
它会影响决定更改形式的阈值,当单个文件内修改总量达到一定值时,会认为该文件进行了完全重写,而不是将一系列删除和插入操作视为修改。如果视为多个删除和插入修改,修改中的行可能会碰巧在文本上与原文一致,从而被当作上下文。选项中的数字
m
控制 -B 选项的这一方面(默认为 60%)。-B/70%
表示,如果在结果中保留的原始内容少于原始内容的 30%,则 Git 认为它是完全重写的(否则,生成的补丁将是一系列删除和插入,并与上下文行混合在一起)。使用 -M 选项时,一个完全改写的文件也被认为是重命名文件的来源(通常 -M 只考查一个消失文件作为重命名的来源)。选项中的数量
n
控制 -B 选项的这一方面(默认为 50%)。-B20%
表明,当插入与删除比 20% 的文件大小更多,该文件可作为重命名到另一文件的可能来源。 - -M[<n>]
- --find-renames[=<n>]
-
如果制成差异,检测并报告每个提交中的重命名。 对于每个在遍历历史时重命名的文件,参见
--follow
。 如果指定了n
,则其为相似度指数阈值(即相比于文件大小的增/删量)。 例如,-M90%
表示如果文件90%以上的内容没有更改,则 Git 应将删除/添加对视为重命名。 如果没有%
符号,则该数字应作为小数读取,并在其前面加上小数点。 即-M5
变为 0.5,因此与-M50%
相同。 同样,-M05
与-M5%
相同。 要将检测限制为精确的重命名,请使用-M100%
。 默认相似度指数为50%。 - -C[<n>]
- --find-copies[=<n>]
-
检测复制与重命名。参见
--find-copies-harder
。如果指定了n
,则其与-M<n>
含义相同。 - --find-copies-harder
-
出于性能考虑,默认情况下,
-C
选项只在复制的原始文件在相同的变更集中被修改时才会查找复制。这个标志使命令检查未修改的文件作为复制源的候选文件。 对于大型项目来说,这是一个非常耗时的操作,所以要谨慎使用。 给出一个以上的-C
选项有同样的效果。 - -D
- --irreversible-delete
-
删除时省略原内容,即只打印头信息,而不打原内容和
/dev/null
之间的差异。所产生的补丁并不是要用于patch
或git apply
;这只是为了让人们只专注于审查修改后的文本。此外,输出结果显然缺乏足够的信息来反转,或手动应用这样一个补丁,因此这个选项的名称如此。当与
-B
一起使用时,也省略删除/创建对中删除部分的原内容。 - -l<数量>
-
-M
和-C
选项涉及一些初步步骤,可以廉价地检测重命名/副本的子集,然后是详尽的后备部分,将所有剩余的未配对目的地与所有相关源进行比较。 (对于重命名,只有剩余的未配对源是相关的;对于副本,所有原始源都是相关的。)对于 N 个源和目的地,这个详尽的检查是 O(N^2)。如果涉及的源/目标文件数量超过指定数量,则此选项可防止重命名/复制检测的详尽部分运行。默认为 diff.renameLimit。请注意,值 0 被视为无限制。 - --diff-filter=[(A|C|D|M|R|T|U|X|B)…[*]]
-
只选择添加(
A
)、复制(C
)、删除(D
)、修改(M
)、重命名(R
)、类型(即常规文件、符号链接、子模块……)改变(T
)、未合并(U
)、未知(X
)或配对被破坏(B
)的文件。可以使用过滤字符的任何组合(包括空)。当组合中加入*
(全部或空)时,如果在比较中有任何文件与其他条件匹配,则选择所有路径;如果没有符合其他条件的文件,则不会选择任何内容。另外,这些大写字母也可以通过使用小写排除。例如:
--diff-filter=ad
排除添加和删除的路径。请注意,并非所有差异都能显示所有类型。例如,如果禁用了复制和重命名条目类型的检测,这些条目就不会出现。
- -S<string>
-
寻找改变文件中指定字符串出现次数的差异(即增加/删除)。供脚本编写者使用。
当您正在寻找确切的代码块(如结构体),并且想知道该块自首次出现以来的历史记录时,这将非常有用:通过
-S
选项迭代,将原文件中的感兴趣的块显示出,并继续进行,直到获得该块的第一个版本。二进制文件也会被搜索到。
- -G<正则表达式>
-
查找其补丁文本包含与 <正则表达式> 匹配的添加/删除行的差异。
为了说明
-S<正则表达式> --pickaxe-regex
和-G<正则表达式>
之间的区别,假设某次提交在同一文件中有以下差异:+ return frotz(nitfol, two->ptr, 1, 0); ... - hit = frotz(nitfol, mf2.ptr, 1, 0);
git log -G "frotz\(nitfol"
会显示这次提交,但git log -S "frotz\(nitfol" --pickaxe-regex
不会显示(因为该字符串的出现次数没有改变)。除非提供
--text
,否则没有 textconv 过滤器的二进制文件补丁将被忽略。更多信息请参见 gitdiffcore[7] 中的 pickaxe 条目。
- --find-object=<对象ID>
-
查找指定对象出现次数的差异。与
-S
类似,只是参数不同:它不搜索特定的字符串,而是搜索特定的对象 id。该对象可以是一个 blob 或一个子模块提交。它意味着
git-log
中的-t
选项也能找到工作树。 - --pickaxe-all
-
当使用
-S
或-G
选项找到一个更改时,显示该更改集中的所有更改,而不仅仅是显示包含 <string> 更改的文件。 - --pickaxe-regex
-
将
-S
选项的 <string> 参数当作扩展的 POSIX 正则表达式来匹配。 - -O<顺序控制文件>
-
控制文件在输出中出现的顺序。这将覆盖
diff.orderFile
配置变量(参见 git-config[1])。要取消diff.orderFile
,请使用-O/dev/null
。输出顺序由 <顺序控制文件> 中的 glob 模式的顺序决定。所有路径名与第一个模式匹配的文件首先输出,路径名与第二个模式匹配(但不与第一个模式匹配)的文件其次输出,以此类推。所有路径名与任何模式匹配的文件会最后输出,就像在文件末尾有一个隐含的全部匹配模式。如果多个路径名具有相同的等级(它们匹配相同的模式,但没有匹配先前的模式),它们相对于彼此的输出顺序是正常的。
<顺序控制文件> 格式如下:
-
空白行会被忽略,因此可以用它们作为分隔符,以保证可读性。
-
以井号("
#
")开头的行会被忽略,所以它们可以用来做注释。如果模式以井号开头,则需要在模式的开头加上反斜杠("\
")。 -
每一行都包含一个模式。
模式的语法和语义与 fnmatch(3) 中使用的相同,不包括 FNM_PATHNAME 标志,但在删除路径名中结尾任意几个成分后匹配的情况下例外。例如,模式 "
foo*bar
" 匹配 "fooasdfbar
" 和 "foo/bar/baz/asdf
",但不匹配 "foobarx
"。 -
- --skip-to=<文件>
- --rotate-to=<文件>
-
从输出中丢弃命名 <文件> 之前的文件(即 skip to),或将它们移到输出的末尾(即 rotate to)。 这些选项主要是为使用
git difftool
命令而发明的,在其他情况下可能用处不大。 - -R
-
交换两个输入;即显示从索引或磁盘文件到目录树内容的差异。
- --relative[=<路径>]
- --no-relative
-
当从项目的子目录中运行时,可以排除目录外的变化,并通过这个选项显示相对于它的路径名。当你不在子目录中时(例如在纯仓库中),你可以通过 <路径> 参数来指明要使输出相对于哪个子目录。
--no-relative
可以用来取消diff.relative`配置选项和之前的 `--relative
选项。 - -a
- --text
-
将一切输入文件视为文本。
- --ignore-cr-at-eol
-
在进行比较时,忽略行末的回车。
- --ignore-space-at-eol
-
忽略行尾空格的变化。
- -b
- --ignore-space-change
-
忽略空格数量的变化。这会忽略行尾的空格,并认为包含一个或多个空格字符的其他序列都是等同的。
- -w
- --ignore-all-space
-
比较行时忽略空格。即使一行有空格而另一行没有空格,也会忽略差异。
- --ignore-blank-lines
-
忽略空白行的变化。
- -I<正则表达式>
- --ignore-matching-lines=<正则表达式>
-
忽略所有行均匹配 <正则表达式> 的更改。 此选项可指定多次。
- --inter-hunk-context=<行数>
-
显示块差异之间的上下文,最多显示指定的行数,从而合并彼此接近的块。 默认认为
diff.interHunkContext
,如果配置选项未设置,则默认为0。 - -W
- --function-context
-
在每个修改中的上下文行显示整个函数。函数名称的确定方式与
git diff
计算补丁头的方式相同(参见 gitattributes[5] 中的 自定义区块头 )。 - --ext-diff
-
允许执行外部差异器。如果你用 gitattributes[5] 设置了一个外部差异驱动程序,你需要在 git-log[1] 和相关命令中使用这个选项。
- --no-ext-diff
-
禁止使用外部差异器。
- --textconv
- --no-textconv
-
允许(或不允许)在比较二进制文件时运行外部文本转换过滤器。详情请参见 gitattributes[5] 。由于文本转换过滤器通常是单向转换,因此产生的差异适合人类用户使用,但不能应用(apply)。因此默认情况下,只有 git-diff[1] 和 git-log[1] 启用文本转换过滤器,而 git-format-patch[1] 或 diff plumbing 命令则不启用。
- --ignore-submodules[=<when>]
-
在生成差异时忽略子模块的修改。<when> 可以是 "none"、"untracked"、"dirty " 或 "all","all" 是默认选项。使用 "none" 会在子模块包含未跟踪或修改的文件,或者它的HEAD 与上级项目中记录的提交不同时,认为它被修改了,并且可以用来覆盖 git-config[1] 或 gitmodules[5] 中 忽略 选项的设置。当使用 "untracked" 时,当子模块只包含未跟踪的内容时,它们不会被认为是有改动的(但它们仍然会被扫描是否有被修改的内容)。使用 "dirty" 会忽略所有对子模块工作树的修改,只有存储在上级项目中的提交的修改才会被显示出来(这是在1.7.0之前的行为)。使用 "all" 会隐藏所有对子模块的修改。
- --src-prefix=<前缀>
-
显示给定的源前缀而不是 "a/"。
- --dst-prefix=<前缀>
-
显示给定的目标前缀,而不是“b/”。
- --no-prefix
-
不显示任何源或目的前缀。
- --default-prefix
-
Use the default source and destination prefixes ("a/" and "b/"). This overrides configuration variables such as
diff.noprefix
,diff.srcPrefix
,diff.dstPrefix
, anddiff.mnemonicPrefix
(seegit-config
(1)). - --line-prefix=<prefix>
-
在每一行输出前加上一个额外的前缀。
- --ita-invisible-in-index
-
默认情况下,通过 "git add -N" 添加的条目在 "git diff" 中显示为现有的空文件,在 "git diff --cached" 中显示为新文件。这个选项使得条目在 "git diff" 中显示为一个新文件,而在 "git diff --cached" 中显示为不存在的文件。这个选项可以用
--ita-visible-in-index
来还原。这两个选项都是试验性的,将来可能会被删除。
关于这些常用选项的更多解释,请参见 gitdiffcore[7]。
使用选项 -p
生成补丁文本
使用 -p
选项运行 git-diff[1]、git-log[1]、git-show[1]、git-diff-index[1]、git-diff-tree[1] 或 git-diff-files[1] 会生成补丁文本。 你可以通过 GIT_EXTERNAL_DIFF
和 GIT_DIFF_OPTS
环境变量(参见 git[1]),以及 diff
属性(参见 gitattributes[5])自定义补丁文本的创建。
-p 选项产生的内容与传统的差异格式略有不同:
-
它前面有一个
git diff
头,如下所示:diff --git a/file1 b/file2
a/
和b/
的文件名相同,除非涉及到重命名/复制。特别地,即使是创建或删除,也 不 使用/dev/null
来代替a/
或b/
文件名。当涉及重命名/复制时,
file1
和file2
分别显示重命名/复制的源文件名和重命名/复制产生的文件名。 -
它的后面是一个或多个扩展头信息行:
old mode <模式> new mode <模式> deleted file mode <模式> new file mode <模式> copy from <路径> copy to <路径> rename from <路径> rename to <路径> similarity index <数字> dissimilarity index <数字> index <哈希>..<哈希> <模式>
文件模式被打印为 6 位八进制数字,包括文件类型和文件权限位。
扩展头信息中的路径名称不包括
a/
和b/
前缀。相似性指数是未改变的行占比,而不相似性指数是改变的行占比。它是四舍五入的整数,后有百分号。因此,100%的相似度指数指为两个文件相等,而 100% 的不相似度意味着入新文件中没有旧文件中的行。
索引行包括改变前和改变后的 blob 对象名称。如果文件模式没有变化,则包含 <模式>;否则,分别显示新旧模式。
-
含有 "不常见" 字符的路径名会被引用,这一点在配置变量` core.quotePath` 中有所解释(见 git-config[1])。
-
输出中所有的
file1
文件都是指提交前的文件,而所有的file2
文件都是指提交后的文件。按顺序对每个文件进行修改是不正确的。例如,这个补丁将交换文件 a 和 b:diff --git a/a b/b rename from a rename to b diff --git a/b b/a rename from b rename to a
-
块头提到了块头所适用的函数的名称。 参见 gitattributes[5] 中的 “定义自定义 hunk-header”,以了解如何针对特定语言进行定制。
合并的差异格式
任何生成差异的命令都可以使用 -c
或 --cc
选项,在显示合并时产生一个 “合并差异”。当用 git-diff[1] 或 git-show[1] 显示合并时,这默认格式。还需要注意的是,你可以给这些命令适当的 --diff-merges
选项来强制生成特定格式的差异。
"合并的差异" 的格式如下:
diff --combined describe.c index fabadb8,cc95eb0..4866510 --- a/describe.c +++ b/describe.c @@@ -98,20 -98,12 +98,20 @@@ return (a_date > b_date) ? -1 : (a_date == b_date) ? 0 : 1; } - static void describe(char *arg) -static void describe(struct commit *cmit, int last_one) ++static void describe(char *arg, int last_one) { + unsigned char sha1[20]; + struct commit *cmit; struct commit_list *list; static int initialized = 0; struct commit_name *n; + if (get_sha1(arg, sha1) < 0) + usage(describe_usage); + cmit = lookup_commit_reference(sha1); + if (!cmit) + usage(describe_usage); + if (!initialized) { initialized = 1; for_each_ref(get_name);
-
它前面有 "git diff" 头,如下(当使用
-c
选项时):diff --combined file
或如下(当使用
--cc
选项时):diff --cc file
-
它的后面是一个或多个扩展头信息行(本例显示的是与两个父提交的合并):
index <哈希>,<哈希>..<哈希> mode <模式>,<模式>..<模式> new file mode <模式> deleted file mode <模式>,<模式>
mode<模式>,<模式>..<模式>
行仅在 <模式> 中至少有一个与其余的不同时才会出现。包含有关检测到的内容移动的信息 (重命名和复制检测) 的扩展标头设计为使用两个 <目录树对象> 的 diff,不能用于组合的 diff 格式。 -
它的后面是两行源文件/目标文件的头信息:
--- a/file +++ b/file
与传统 ‘统一’ diff 格式的双行标题类似,
/dev/null
用于表示已创建或已删除的文件。但是,如果提供了 --combined-all-paths 选项,你就会得到一个 N+1 行的源文件/目标文件头,其中 N 是合并提交中的父提交数量:
--- a/file --- a/file --- a/file +++ b/file
如果重命名或复制检测处于活动状态,这种扩展格式可能很有用,可以让你在不同的父提交中看到文件的原始名称。
-
修改了文件块头信息的格式,以防止不小心将其送入
patch -p1
。合并的差异格式是为审查合并提交的修改而创建的,并不是为了应用。这个变化类似于扩展的 "索引" 头信息的变化:@@@ <from-file-range> <from-file-range> <to-file-range> @@@
块中有(父提交数量+1)
@
字符,用于合并的差异格式。
与传统的 "统一" 差异格式不同,这种格式显示两个文件 A 和 B 的列,其中有 -
(减号 — 在 A 中出现,但在 B 中删除),+
(加号 — 在 A 中缺少,但在 B 中增加),或 " "
(空格 — 不变)前缀,这种格式比较两个或多个文件与一个文件 X,并显示 X 与其中每个文件的差异。文件中的每一个都有一列被前置在输出行中,以指出 X 的行与它的不同之处。
第 N 列中的 -
字符意味着该行出现在文件 N 中,但它没有出现在结果文件中。第 N 列中的 +
字符意味着该行出现在结果文件中,而文件 N 中没有该行(换句话说,从该父提交的角度来看,该行是被添加的)。
在上面的输出示例中,两个文件中的函数签名都被改变了(因此从文件 1 和文件 2 中都有表示删除的 -
,而 ++
表示被添加的一行没有出现在文件 1 或文件 2 中)。另外还有 8 行与文件 1 中的相同,但没有出现在文件 2 中(因此前缀为 +
)。
当用 git diff-tree -c
显示时,它将合并提交的父提交文件与合并结果进行比较(即文件 1 … 文件 N 是父提交文件)。当用 git diff-files -c
显示时,它将两个未解决的合并父提交文件与工作树文件进行比较(即文件 1 是阶段 2 ,又称 "我们的版本",文件 2 是阶段 3,又称 "他们的版本")。
实例
-
git show v1.0.0
-
显示标签
v1.0.0
,以及标签指向的对象。 -
git show v1.0.0^{tree}
-
显示标签`v1.0.0`所指向的树。
-
git show -s --format=%s v1.0.0^{commit}
-
显示由标签`v1.0.0`指向的提交的主题。
-
git show next~10:Documentation/README
-
显示`Documentation/README`文件的内容,因为它们在分支`next`的最后10次提交中是当前的。
-
git show master:Makefile master:t/Makefile
-
将上述Makefiles的内容串联在分支`master`的头部。
讨论
Git在某种程度上是与字符编码无关的。
-
blob对象的内容是未经解释的字节序列。 在核心层没有编码转换。
-
路径名以UTF-8规范化形式C编码,这适用于树对象、索引文件、参考名称,以及命令行参数、环境变量和配置文件(
.git/config
(见git-config[1]),gitignore[5],gitattributes[5] 和gitmodules[5])中的路径名。请注意,Git 在核心层将路径名简单地视为非 NUL 字节的序列,没有路径名编码的转换(除了 Mac 和 Windows)。因此,即使在使用传统的扩展ASCII编码的平台和文件系统上,使用非ASCII的路径名大多也能工作。然而,在这种系统上创建的仓库在基于UTF-8的系统(如Linux、Mac、Windows)上将无法正常工作,反之亦然。 此外,许多基于Git的工具简单地认为路径名称是UTF-8,而不能正确显示其他编码。
-
提交日志信息通常以UTF-8编码,但也支持其他扩展ASCII编码。这包括ISO-8859-x、CP125x和其他许多编码,但不包括UTF-16/32、EBCDIC和CJK多字节编码(GBK、Shift-JIS、Big5、EUC-x、CP9xx等)。
尽管我们鼓励提交日志信息使用UTF-8编码,但核心系统和Git Porcelain的设计并不强制要求项目使用UTF-8。 如果某个项目的所有参与者都认为使用传统编码更方便,Git也不会禁止。 然而,有几件事需要注意。
-
git commit 和 git commit-tree 如果收到的提交日志信息不像是有效的 UTF-8 字符串,就会发出警告,除非你明确表示你的项目使用的是传统编码。 说这个的方法是在
.git/config
文件中设置i18n.commitEncoding
,像这样:[i18n] commitEncoding = ISO-8859-1
用上述设置创建的提交对象在它的
encoding
头中记录了i18n.commitEncoding
的值。 这是为了帮助以后看这些对象的人。 缺少这个头意味着提交日志信息是以 UTF-8 编码的。 -
git log 、git show 、git blame 和它们的朋友们会查看提交对象的
encoding
头,并尝试将日志信息重新编码为 UTF-8,除非另有指定。 您可以在`.git/config` 文件中使用i18n.logOutputEncoding
指定所需的输出编码,像这样:[i18n] logOutputEncoding = ISO-8859-1
如果你没有这个配置变量,则使用`i18n.commitEncoding`的值来代替。
请注意,我们特意选择在提交对象层面上,不对提交日志信息进行重新编码,因为重新编码为UTF-8不一定是一个可逆的操作。
GIT
属于 git[1] 文档