Git
简体中文 ▾ Topics ▾ Latest version ▾ git-checkout-index last updated in 2.43.0

名称

git-checkout-index - 将文件从索引复制到工作目录树

概述

git checkout-index [-u] [-q] [-a] [-f] [-n] [--prefix=<字符串>]
		   [--stage=<数字>|all]
		   [--temp]
		   [--ignore-skip-worktree-bits]
		   [-z] [--stdin]
		   [--] [<文件>…​]

描述

将索引中列出的所有文件复制到工作目录（不会覆盖现有文件）。

选项

-u
--index

更新索引文件中已签出条目的统计信息。

-q
--quiet

如果文件存在或不在索引中，则保持安静

-f
--force

强制覆盖现有文件

-a
--all

检查索引中的所有文件，但设置了跳过工作树位的文件除外（参见 --ignore-skip-worktree-bits）。 不能与显式文件名一起使用。

-n
--no-create

不签出新文件，只刷新已签出的文件。

--prefix=<字符串>

创建文件时，预输入 <字符串>（通常是目录，包括尾部的 /）

--stage=<数量>|all

不检查未合并的条目，而是从命名的阶段复制出文件。 <数字> 必须介于 1 和 3 之间。 注意：--stage=all 自动隐含 --temp。

--temp

与其将文件复制到工作目录，不如将内容写入临时文件。 临时名称关联将写入标准输出流。

--ignore-skip-worktree-bits

检查所有文件，包括设置了跳过工作树位的文件。

--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 文件替换为其缓存副本。如果空命令行意味着 "all"，那么这将强制刷新索引中的所有内容，而这并不是重点。 但由于 "git checkout-index" 接受 --stdin，因此使用起来会更快：

$ find . -name '*.h' -print0 | git checkout-index -f -z --stdin

当你知道其余的都是文件名时，-- 是一个好主意；它可以防止出现文件名为 -a 的问题。 在脚本中使用 -- 可能是个好主意。

使用 --temp 或 --stage=all

当使用了 --temp（或由 `--stage=all`隐含）时，"git checkout-index" 将为每个被检出的索引条目创建一个临时文件。 索引不会更新统计信息。 如果调用者需要所有未合并条目的所有阶段，以便外部合并工具可以处理这些未合并文件，那么这些选项会很有用。

将向标准输出流写入一个列表，提供临时文件名与跟踪路径名之间的关联。 列表格式有两种：

  1. 临时名称 TAB 路径 RS

    语类型：纯文本 第一种格式是省略 --stage 或不使用 --stage=all 时使用的格式。字段临时名称是保存文件内容的临时文件名，路劲是索引中的跟踪路径名。 只输出所请求的条目。

  2. 阶段一缓存 SP 阶段二缓存 SP 阶段三缓存 TAB 路径 RS

    第二种格式是在 --stage=all 时使用的格式。 如果索引中有阶段条目，三个阶段临时字段（阶段一缓存、阶段二缓存、阶段三换粗）会列出临时文件的名称；如果没有阶段条目，则会列出 .。 只有阶段 0 条目的路径将始终从输出中省略。

在这两种格式中，RS（记录分隔符）默认都是换行符，但如果在命令行中输入了 -z，RS（记录分隔符）就会变成空字节。 临时文件名始终是安全字符串，绝不包含目录分隔符或空白字符。 路径字段始终相对于当前目录，临时文件名始终相对于顶层目录。

如果被复制到临时文件中的对象是一个符号链接，那么该链接的内容将被写入一个普通文件。 最终用户或 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 中。

GIT

属于 git[1] 文档

scroll-to-top