git-add - 云端在线

程序：

您的姓名

git-add - 将文件内容添加到索引

概要

混帐 加 [--详细 | -v] [--dry-run | -n] [--force | -f] [--交互式 | -i] [--补丁 | -p]
[--编辑 | -e] [--[no-]all | --[no-]ignore-removal | [--更新 | -u]]]
[--意图添加 | -N] [--refresh] [--ignore-errors] [--ignore-missing]
[--] [ ...]

商品描述

此命令使用在工作树中找到的当前内容更新索引，以
为下一次提交准备上演的内容。 它通常会添加当前的内容
现有路径作为一个整体，但通过一些选项，它还可以用于添加内容
仅应用了对工作树文件所做的更改的一部分，或删除了执行此操作的路径
不再存在于工作树中。

“索引”持有工作树内容的快照，就是这个快照
这被视为下一次提交的内容。 因此，在对
工作树，并且在运行 commit 命令之前，必须使用 add 命令添加
索引的任何新文件或修改文件。

此命令可以在提交前多次执行。 它只添加了内容
运行添加命令时的指定文件； 如果您想要后续更改
包含在下一次提交中，那么您必须再次运行 git add 以将新内容添加到
指数。

git status 命令可用于获取哪些文件发生更改的摘要
为下一次提交而上演。

git add 命令默认不会添加被忽略的文件。 如果任何被忽略的文件是
在命令行上明确指定， git add 将失败并显示被忽略的文件列表。
由 Git 执行的目录递归或文件名通配所到达的忽略文件（引用
外壳之前的 glob）将被静默忽略。 这 混帐 加 命令可用于
使用 -f（强制）选项添加被忽略的文件。

请参阅 git提交(1) 用于向提交添加内容的替代方法。

配置

...
要从中添加内容的文件。 可以给出 Fileglobs（例如 *.c）来添加所有匹配的
文件。 也可以是前导目录名称（例如 dir 添加 dir/file1 和 dir/file2）
给出更新索引以匹配整个目录的当前状态（例如
指定 dir 不仅会记录在工作树中修改的文件 dir/file1，
文件 dir/file2 添加到工作树中，但也从工作树中删除了文件 dir/file3
工作树。 请注意，旧版本的 Git 过去常常忽略已删除的文件； 用
--no-all 选项，如果您想添加修改过的或新的文件但忽略已删除的文件。

-n, --试运行
不要实际添加文件，只需显示它们是否存在和/或将被忽略。

-v，--详细
详细点。

-f，--强制
允许添加否则被忽略的文件。

-i，--交互式
以交互方式将工作树中的修改内容添加到索引中。 可选路径
可以提供参数以将操作限制为工作树的子集。 看
“交互模式”了解详情。

-p，--补丁
在索引和工作树之间交互选择补丁块并添加它们
到索引。 这使用户有机会在添加之前查看差异
修改了索引的内容。

这有效地运行 add --interactive，但绕过初始命令菜单和
直接跳转到patch子命令。 有关详细信息，请参阅“交互模式”。

-e， - 编辑
在编辑器中打开差异与索引并让用户编辑它。 编辑后
已关闭，调整大块头并将补丁应用于索引。

此选项的目的是选择要应用的补丁行，甚至
修改要上演的行的内容。 这可以更快更灵活
而不是使用交互式大块选择器。 然而，很容易混淆自己和
创建一个不适用于索引的补丁。 请参阅下面的编辑补丁。

-u，--更新
更新索引已经有匹配项的位置. 这将删除
以及修改索引条目以匹配工作树，但不添加新文件。

如果不使用 -u 选项时给出，整个文件中的所有跟踪文件
更新工作树（旧版本的 Git 用于将更新限制为当前
目录及其子目录）。

-A, --all, --no-ignore-removal
不仅在工作树有文件匹配的地方更新索引但
还有索引已经有一个条目的地方。 这将添加、修改和删除索引
条目以匹配工作树。

如果不使用 -A 选项时给出，整个工作树中的所有文件
更新（旧版本的 Git 用于限制更新到当前目录和
其子目录）。

--no-all, --ignore-removal
通过添加索引未知的新文件和修改的文件来更新索引
在工作树中，但忽略已从工作树中删除的文件。
当没有时，此选项是空操作用来。

这个选项主要是为了帮助习惯了旧版 Git 的用户，他们的
"git 添加...”是“git add --no-all”的同义词...“， IE
忽略已删除的文件。

-N, --意图添加
仅记录路径将在以后添加的事实。 路径的条目是
放置在没有内容的索引中。 除其他外，这对于显示
使用 git diff 并使用 git commit 提交此类文件的未暂存内容
-和。

- 刷新
不要添加文件，而只是在索引中刷新它们的 stat() 信息。

--忽略错误
如果由于索引错误而无法添加某些文件，请不要中止
操作，但继续添加其他人。 该命令仍应以非零值退出
地位。 可以将配置变量 add.ignoreErrors 设置为 true 以使其
默认行为。

--忽略缺失
此选项只能与--dry-run 一起使用。 通过使用此选项，用户
可以检查是否有任何给定的文件会被忽略，无论它们是否已经存在
是否存在于工作树中。

--
此选项可用于将命令行选项与文件列表分开，
（当文件名可能被误认为是命令行选项时很有用）。

配置

可选的配置变量 core.excludesFile 表示文件的路径
包含要从 git-add 中排除的文件名模式，类似于
$GIT_DIR/信息/排除。 除了使用排除文件中的模式之外，还使用了排除文件中的模式
信息/排除。 看 吉蒂诺尔（5）。

示例

· 添加文档目录下所有 *.txt 文件的内容及其
子目录：

$ git add 文档/\*.txt

请注意，在本例中，星号 * 是从 shell 引用的； 这让
命令包括来自 Documentation/ 目录子目录的文件。

· 考虑从所有 git-*.sh 脚本添加内容：

$ git 添加 git-*.sh

因为这个例子让 shell 扩展星号（即你列出了
文件），它不考虑 subdir/git-foo.sh。

互动 MODE

当命令进入交互模式时，它会显示输出 状态
子命令，然后进入其交互式命令循环。

命令循环显示可用子命令的列表，并给出提示“What now>”。
一般来说，当提示以单个结尾时 >，您只能选择其中一项
给定并输入返回，如下所示：

*** 命令 ***
1：状态 2：更新 3：恢复 4：添加未跟踪
5：补丁 6：差异 7：退出 8：帮助
现在什么> 1

只要选择是唯一的，您也可以说 s 或 sta 或 status 以上。

主命令循环有 6 个子命令（加上帮助和退出）。

状态
这显示了 HEAD 和索引之间的变化（即，如果您说
git commit），以及索引和工作树文件之间（即你可以暂存的
在 git commit 之前进一步使用 git add) 为每个路径。 示例输出看起来像
这个：

阶段性非阶段性路径
1：二进制没有 foo.png
2: +403/-35 +1/-1 git-add--interactive.perl

它表明 foo.png 与 HEAD 不同（但这是二进制的，所以行数
无法显示）并且索引副本和工作树之间没有区别
版本（如果工作树版本也不同， 二进制 会被展示
代替 没什么）。 另一个文件 git-add--interactive.perl 添加了 403 行
如果您提交索引中的内容，则会删除 35 行，但工作树文件有
进一步修改（一个添加和一个删除）。

更新
这将显示状态信息并发出“更新>>”提示。 当提示
以双结束 >>，您可以进行多个选择，并与
空格或逗号。 你也可以说范围。 例如 "2-5 7,9" 选择 2,3,4,5,7,9
从列表中。 如果省略范围中的第二个数字，则所有剩余的补丁都是
采取。 例如“7-”从列表中选择 7,8,9。 你可以说 * 选择一切。

然后您选择的内容将突出显示 *，像这样：

阶段性非阶段性路径
1：二进制没有 foo.png
* 2: +403/-35 +1/-1 git-add--interactive.perl

要删除选择，请在输入前加上 - 像这样：

更新>> -2

选择后，用空行回答工作内容
索引中选定路径的树文件。

还原
这有一个非常相似的用户界面 更新, 以及所选路径的暂存信息
恢复为 HEAD 版本。 恢复新路径会使它们未被跟踪。

添加未跟踪
这有一个非常相似的用户界面 更新 和 还原, 并允许您将未跟踪的路径添加到
指数。

补丁
这使您可以从一条路径中选择一条 状态 喜欢选择。 选好路线后，
它显示了索引和工作树文件之间的差异，并询问您是否
想上演每一个帅哥的变化。 您可以选择以下选项之一并
类型返回：

y - 上演这个大块头
n - 不要上演这个大块头
q - 退出； 不要上演这个大块头或任何剩余的大块头
a - 在文件中暂存这个大块头和所有后来的大块头
d - 不要在文件中暂存这个大块头或任何后面的大块头
g - 选择一个大块去
/ - 搜索匹配给定正则表达式的大块头
j - 让这个大块未定，看下一个未定的大块
J - 让这个大块头未定，看下一个大块头
k - 让这个大块未定，见上一个未定的大块
K - 让这个大块头未定，参见上一个大块头
s - 将当前大块分割成更小的大块
e - 手动编辑当前块
? - 打印帮助

在决定了所有帅哥的命运后，如果有被选中的帅哥，指数
用选定的帅哥更新。

通过设置配置变量，您可以省略必须在此处键入 return
Interactive.singleKey 为真。

差异
这让您可以查看将提交的内容（即在 HEAD 和索引之间）。

编辑 补丁

调用 git add -e 或从交互式大块选择器中选择 e 将在
你的编辑器； 编辑器退出后，结果将应用于索引。 你可以自由地
对补丁进行任意更改，但请注意，某些更改可能会造成混淆
结果，甚至导致无法应用的补丁。 如果你想中止
完全操作（即在索引中暂存任何新内容），只需删除所有行
修补。 下面的列表描述了您可能会在补丁中看到的一些常见内容，以及
编辑操作对它们有意义。

添加的内容
添加的内容由以“+”开头的行表示。 您可以防止暂存任何
通过删除它们来添加行。

删除的内容
删除的内容由以“-”开头的行表示。 您可以防止分期
通过将“-”转换为“”（空格）来删除它们。

修改内容
修改后的内容用“-”行表示（去掉旧内容）后跟
“+”行（添加替换内容）。 您可以防止暂存修改
通过将“-”行转换为“”，并删除“+”行。 注意只修改
对的一半可能会给指数带来令人困惑的变化。

还可以执行更复杂的操作。 但要注意，因为
补丁仅应用于索引而不是工作树，工作树将出现
“撤消”索引中的更改。 例如，在索引中引入一个新行
在 HEAD 和工作树中都不会暂存新行以进行提交，但是
行将在工作树中恢复。

避免使用这些结构，或极其谨慎地使用。

删除未触及的内容
索引和工作树之间没有差异的内容可能会显示在
上下文行，以“”（空格）开头。 您可以暂存上下文行以进行删除
通过将空格转换为“-”。 生成的工作树文件将显示为
重新添加内容。

修改现有内容
还可以通过暂存它们以进行删除来修改上下文行（通过将“”转换为
"-") 并在新内容中添加一个 "+" 行。 同样，可以修改“+”行
对于现有的添加或修改。 在所有情况下，新的修改将
出现在工作树中。

新内容
您还可以添加补丁中不存在的新内容； 只需添加新行，
每个都以“+”开头。 添加将在工作树中恢复。

还有一些操作应该完全避免，因为它们会使
无法应用的补丁：

· 添加上下文 (" ") 或删除 ("-") 行

· 删除上下文或删除行

· 修改上下文或删除行的内容

使用 onworks.net 服务在线使用 git-add