设置和配置
获取和创建项目
基本快照
分支和合并
共享和更新项目
检查和比较
补丁
调试
邮件
外部系统
服务器管理
指南
管理
底层命令
- 2.47.1 → 2.49.0 无更改
-
2.47.0
2024-10-06
- 2.43.1 → 2.46.3 无更改
-
2.43.0
2023-11-20
- 2.40.1 → 2.42.4 无更改
-
2.40.0
2023-03-12
- 2.38.1 → 2.39.5 无更改
-
2.38.0
2022-10-02
- 2.35.1 → 2.37.7 无更改
-
2.35.0
2022-01-24
- 2.32.1 → 2.34.8 无更改
-
2.32.0
2021-06-06
- 2.29.1 → 2.31.8 无更改
-
2.29.0
2020-10-19
- 2.19.1 → 2.28.1 无更改
-
2.19.0
2018-09-10
- 2.18.1 → 2.18.5 无更改
-
2.18.0
2018-06-21
- 2.16.6 → 2.17.6 无更改
-
2.15.4
2019-12-06
- 2.14.6 无更改
-
2.13.7
2018-05-22
- 2.9.5 → 2.12.5 无更改
-
2.8.6
2017-07-30
- 2.5.6 → 2.7.6 无更改
-
2.4.12
2017-05-05
-
2.3.10
2015-09-28
- 2.1.4 → 2.2.3 无更改
-
2.0.5
2014-12-17
概要
git apply [--stat] [--numstat] [--summary] [--check] [--index | --intent-to-add] [--3way] [--ours | --theirs | --union] [--apply] [--no-add] [--build-fake-ancestor=<file>] [-R | --reverse] [--allow-binary-replacement | --binary] [--reject] [-z] [-p<n>] [-C<n>] [--inaccurate-eof] [--recount] [--cached] [--ignore-space-change | --ignore-whitespace] [--whitespace=(nowarn|warn|fix|error|error-all)] [--exclude=<path>] [--include=<path>] [--directory=<root>] [--verbose | --quiet] [--unsafe-paths] [--allow-empty] [<patch>…]
描述
读取提供的 diff 输出 (即 "补丁") 并将其应用于文件。从仓库的子目录运行时,将忽略目录外的已修补路径。使用 --index
选项,补丁也将应用于索引,使用 --cached
选项,补丁仅应用于索引。如果没有这些选项,该命令仅将补丁应用于文件,并且不需要它们位于 Git 仓库中。
此命令应用补丁但不创建提交。使用 git-am[1] 从 git-format-patch[1] 生成的和/或通过电子邮件收到的补丁创建提交。
选项
- <patch>…
-
从中读取补丁的文件。- 可以用于从标准输入读取。
- --stat
-
代替应用补丁,输出输入的 diffstat。关闭 "apply"。
- --numstat
-
类似于
--stat
,但是以十进制表示法显示添加和删除的行数,以及没有缩写的路径名,使其更易于机器读取。对于二进制文件,输出两个-
,而不是说0 0
。关闭 "apply"。 - --summary
-
代替应用补丁,输出从 git diff 扩展头获得的信息的简明摘要,例如创建、重命名和模式更改。关闭 "apply"。
- --check
-
代替应用补丁,查看该补丁是否适用于当前工作树和/或索引文件,并检测错误。关闭 "apply"。
- --index
-
将补丁同时应用于索引和工作树 (或者如果
--check
生效,则仅检查它是否可以干净地应用于两者)。请注意,--index
期望相关路径的索引条目和工作树副本相同 (它们的内容和元数据(如文件模式)必须匹配),如果它们不匹配,即使补丁可以干净地应用于索引和工作树,也会引发错误。 - --cached
-
仅将补丁应用于索引,而不触及工作树。如果
--check
生效,则仅检查它是否可以干净地应用于索引条目。 - --intent-to-add
-
仅将补丁应用于工作树时,将新文件标记为稍后添加到索引 (请参阅 git-add[1] 中的
--intent-to-add
选项)。除非在 Git 仓库中运行且未指定--index
,否则将忽略此选项。请注意,--index
可能被其他选项暗示,例如--cached
或--3way
。 - -3
- --3way
-
如果补丁记录了它应该应用到的 blob 的身份,并且我们在本地有这些 blob,则尝试 3 向合并,可能会将冲突标记留在工作树中的文件中,供用户解决。此选项隐含
--index
选项,除非使用--cached
选项,并且与--reject
选项不兼容。与--cached
选项一起使用时,任何冲突都会留在缓存的更高阶段。 - --ours
- --theirs
- --union
-
代替将冲突留在文件中,解决冲突,倾向于我们 (或他们或两者) 方面的行。需要 --3way。
- --build-fake-ancestor=<file>
-
较新的 git diff 输出为每个 blob 嵌入了 索引信息,以帮助识别补丁适用的原始版本。当给出此标志时,如果 blob 的原始版本在本地可用,则构建包含这些 blob 的临时索引。
当遇到纯模式更改 (没有索引信息) 时,将从当前索引中读取信息。
- -R
- --reverse
-
反向应用补丁。
- --reject
-
为了原子性,默认情况下,当某些 hunk 不适用时,git apply 会使整个补丁失败,并且不会触及工作树。此选项使其应用适用的补丁部分,并将拒绝的 hunk 留在相应的 *.rej 文件中。
- -z
-
当给出
--numstat
时,不要修改路径名,而是使用以 NUL 结尾的机器可读格式。如果没有此选项,则具有 "不寻常" 字符的路径名将按照配置变量
core.quotePath
解释的进行引用 (请参阅 git-config[1])。 - -p<n>
-
从传统的 diff 路径中删除 <n> 个前导路径组件 (用斜杠分隔)。例如,使用
-p2
,针对a/dir/file
的补丁将直接应用于file
。默认为 1。 - -C<n>
-
确保每个更改之前和之后至少有 <n> 行的周围上下文匹配。当周围上下文的行数较少时,它们都必须匹配。默认情况下,永远不会忽略上下文。
- --unidiff-zero
-
默认情况下,git apply 期望应用的补丁是统一 diff,至少有一行上下文。这提供了良好的安全措施,但是在应用使用
--unified=0
生成的 diff 时会中断。要绕过这些检查,请使用--unidiff-zero
。请注意,由于上述原因,不鼓励使用无上下文补丁。
- --apply
-
如果使用上面标记为 "关闭 apply" 的任何选项,git apply 会读取并输出请求的信息,而实际上不应用补丁。在这些标志之后给出此标志也可以应用补丁。
- --no-add
-
应用补丁时,忽略补丁所做的添加。这可以用于通过首先对两个文件运行 diff 并使用此选项应用结果来提取两个文件之间的公共部分,这将应用删除部分但不应用添加部分。
- --allow-binary-replacement
- --binary
-
从历史上看,我们不允许在没有用户明确许可的情况下应用二进制补丁,并且此标志是执行此操作的方式。目前,我们始终允许应用二进制补丁,因此这是一个空操作。
- --exclude=<path-pattern>
-
不要将更改应用于与给定路径模式匹配的文件。这在导入补丁集时很有用,可以排除某些文件或目录。
- --include=<路径模式>
-
将更改应用于与给定路径模式匹配的文件。这在导入补丁集时很有用,可以包含某些文件或目录。
当使用
--exclude
和--include
模式时,会按照它们在命令行上出现的顺序进行检查,第一个匹配项决定是否使用针对每个路径的补丁。 如果命令行上没有 include 模式,则默认情况下会使用与任何 include/exclude 模式都不匹配的路径的补丁,如果存在任何 include 模式,则忽略该补丁。 - --ignore-space-change
- --ignore-whitespace
-
应用补丁时,如果需要,忽略上下文行中的空格更改。上下文行将保留其空格,并且无论
--whitespace
选项的值如何,它们都不会进行空格修复。但是,新行仍然会被修复。 - --whitespace=<动作>
-
应用补丁时,检测是否有新的或修改的行具有空格错误。什么是空格错误由
core.whitespace
配置控制。 默认情况下,尾随空格(包括仅由空格组成的行)和紧跟在行初始缩进中的制表符空格被认为是空格错误。默认情况下,该命令会输出警告消息,但会应用补丁。当
git-apply
用于统计而不是应用补丁时,它默认为nowarn
。您可以使用不同的
<动作>
值来控制此行为-
nowarn
关闭尾随空格警告。 -
warn
为一些此类错误输出警告,但按原样应用补丁(默认)。 -
fix
为一些此类错误输出警告,并在修复后应用补丁(strip
是同义词 — 该工具过去只将尾随空格字符视为错误,并且修复涉及 *stripping* 它们,但现代 Git 会做更多的事情)。 -
error
为一些此类错误输出警告,并拒绝应用补丁。 -
error-all
类似于error
,但显示所有错误。
-
- --inaccurate-eof
-
在某些情况下,某些版本的 *diff* 无法正确检测到文件末尾缺少换行符。因此,由此类 *diff* 程序创建的补丁无法正确记录不完整的行。此选项通过解决此错误来增加对应用此类补丁的支持。
- -v
- --verbose
-
向 stderr 报告进度。默认情况下,只会打印有关正在应用的当前补丁的消息。此选项将导致报告其他信息。
- -q
- --quiet
-
禁止 stderr 输出。有关补丁状态和进度的消息将不会打印。
- --recount
-
不要信任 hunk 标头中的行数,而是通过检查补丁来推断它们(例如,在编辑补丁而不适当地调整 hunk 标头之后)。
- --directory=<root>
-
将 <root> 添加到所有文件名的前面。如果还传递了 "-p" 参数,则在添加新根目录之前应用它。
例如,一个讨论将
a/git-gui.sh
更新为b/git-gui.sh
的补丁可以通过运行git apply --directory=modules/git-gui
应用到工作树modules/git-gui/git-gui.sh
中的文件。 - --unsafe-paths
-
默认情况下,影响工作区域外部的补丁(无论是 Git 控制的工作树,还是当“git apply”用作 GNU patch 的替代品时的当前工作目录)会被拒绝,因为这是一个错误(或恶作剧)。
当
git apply
用作“更好的 GNU patch”时,用户可以传递--unsafe-paths
选项来覆盖此安全检查。当使用--index
或--cached
时,此选项无效。 - --allow-empty
-
不要为包含无差异的补丁返回错误。这包括空补丁和仅包含提交文本的补丁。
配置
本节中此行下的所有内容均从 git-config[1] 文档中选择性包含。 内容与在那里找到的内容相同
- apply.ignoreWhitespace
-
当设置为 *change* 时,告诉 *git apply* 忽略空格中的更改,方式与
--ignore-space-change
选项相同。当设置为以下选项之一时:no、none、never、false,它告诉 *git apply* 尊重所有空格差异。请参阅 git-apply[1]。 - apply.whitespace
-
告诉 *git apply* 如何处理空格,方式与
--whitespace
选项相同。请参阅 git-apply[1]。
子模块
如果补丁包含对子模块的任何更改,则 *git apply* 按如下方式处理这些更改。
如果指定了 --index
(显式或隐式),则子模块提交必须与索引完全匹配,才能应用补丁。 如果任何子模块被检出,那么这些检出将被完全忽略,即,不需要它们是最新的或干净的,并且它们不会被更新。
如果未指定 --index
,则补丁中的子模块提交将被忽略,并且只会检查和(如果可能)更新相应子目录的缺失或存在。
GIT
属于 git[1] 套件的一部分