设置和配置
获取和创建项目
基本快照
分支与合并
共享和更新项目
检查和比较
打补丁
调试
电子邮件
外部系统
服务器管理
- 2.43.1 → 2.50.1 无更改
-
2.43.0
2023-11-20
- 2.36.1 → 2.42.4 无变更
-
2.36.0
2022-04-18
- 2.1.4 → 2.35.8 无变更
-
2.0.5
2014-12-17
概要
git checkout-index [-u] [-q] [-a] [-f] [-n] [--prefix=<string>] [--stage=<number>|all] [--temp] [--ignore-skip-worktree-bits] [-z] [--stdin] [--] [<file>…]
选项
- -u
- --index
-
更新索引文件中已检出条目的统计信息。
- -q
- --quiet
-
如果文件存在或不在索引中则保持安静
- -f
- --force
-
强制覆盖现有文件
- -a
- --all
-
检出索引中的所有文件,但那些设置了 skip-worktree 位的文件除外(参见
--ignore-skip-worktree-bits
)。不能与显式文件名一起使用。 - -n
- --no-create
-
不检出新文件,只刷新已检出的文件。
- --prefix=<string>
-
创建文件时,在文件名前加上 <string>(通常是包含尾部斜杠的目录)
- --stage=<number>|all
-
不是检出未合并的条目,而是从指定阶段复制文件。<number> 必须在 1 到 3 之间。注意:--stage=all 会自动隐含 --temp。
- --temp
-
不将文件复制到工作目录,而是将内容写入临时文件。临时名称关联将被写入标准输出。
- --ignore-skip-worktree-bits
-
检出所有文件,包括那些设置了 skip-worktree 位的文件。
- --stdin
-
不是从命令行获取路径列表,而是从标准输入读取路径列表。默认情况下,路径由换行符 (LF) 分隔(即每行一个路径)。
- -z
-
仅在与
--stdin
结合使用时有意义;路径使用 NUL 字符而不是 LF 分隔。 - --
-
不再将任何后续参数解释为选项。
曾经标志的顺序很重要,但现在不再重要了。
仅仅执行 git
checkout-index
不会做任何事情。你可能想执行 git
checkout-index
-a
。如果你想强制执行,则需要 git
checkout-index
-f
-a
。
直观性不是这里的目标。可重复性才是。命令“无参数则无操作”行为的原因是,你可以在脚本中执行以下操作:
$ find . -name '*.h' -print0 | xargs -0 git checkout-index -f --
这将强制所有现有 *.h
文件被其缓存副本替换。如果空命令行意味着“全部”,那么这将强制刷新索引中的所有内容,这不是目的。但由于 git checkout-index 接受 --stdin,因此使用以下方式会更快:
$ find . -name '*.h' -print0 | git checkout-index -f -z --stdin
当你确定其余参数是文件名时,--
是一个好主意;它将防止出现例如 -a
这样的文件名引起的问题。在脚本中使用 --
可能是一个好策略。
使用 --temp 或 --stage=all
当使用 --temp
(或由 --stage=all
隐含)时,git checkout-index 将为每个正在检出的索引条目创建一个临时文件。索引不会更新统计信息。如果调用者需要所有未合并条目的所有阶段,以便外部合并工具可以处理未合并的文件,则这些选项会很有用。
一个列表将被写入标准输出,提供临时文件名与跟踪路径名的关联。列表格式有两种变体:
-
临时文件名 TAB 路径 RS
第一种格式用于当省略
--stage
或其值不是--stage=all
时。字段 tempname 是保存文件内容的临时文件名,而 path 是索引中的跟踪路径名。只输出请求的条目。 -
阶段1临时文件 SP 阶段2临时文件 SP 阶段3临时文件 TAB 路径 RS
第二种格式用于当使用
--stage=all
时。三个阶段临时字段(stage1temp, stage2temp, stage3temp)列出临时文件的名称,如果索引中存在阶段条目,或者为.
(如果没有阶段条目)。只有阶段 0 条目的路径将始终从输出中省略。
在这两种格式中,RS(记录分隔符)默认为换行符,但如果命令行中传递了 -z,则为 null 字节。临时文件名始终是安全字符串;它们绝不包含目录分隔符或空白字符。路径字段始终相对于当前目录,临时文件名始终相对于顶层目录。
如果复制到临时文件的对象是符号链接,则链接的内容将写入普通文件。最终用户或 Porcelain 负责利用此信息。
示例
- 仅更新和刷新已检出的文件
-
$ git checkout-index -n -f -a && git update-index --ignore-missing --refresh
- 使用 git checkout-index “导出整个树”
-
前缀功能使得使用 git checkout-index 作为“导出为树”功能变得非常简单。只需将所需的树读入索引,然后执行:
$ git checkout-index --prefix=git-export-dir/ -a
git
checkout-index
将把索引“导出”到指定的目录中。末尾的“/”很重要。导出的名称字面上只是在前面加上了指定的字符串。将其与以下示例进行对比。
- 带前缀导出文件
-
$ git checkout-index --prefix=.merged- Makefile
这将把当前缓存的
Makefile
副本检出到文件.merged-Makefile
中。