简体中文 ▾ 主题 ▾ 最新版本 ▾ git-checkout-index 上次更新于 2.43.0

名称

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

概要

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

不是将文件复制到工作目录，而是将内容写入临时文件。临时文件名关联将写入 stdout。

--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 将为每个要检出的索引条目创建一个临时文件。索引不会用统计信息进行更新。如果调用者需要所有未合并条目的所有阶段，以便外部合并工具可以处理这些未合并的文件，则这些选项可能很有用。

将向 stdout 写入一个列表，提供临时文件名与跟踪路径名的关联。列表格式有两种变体

  1. tempname TAB path RS

    第一种格式是在省略 --stage 或它不是 --stage=all 时使用的。字段 tempname 是包含文件内容的临时文件名，path 是索引中的跟踪路径名。只输出请求的条目。

  2. stage1temp SP stage2temp SP stage3tmp TAB path 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`。

GIT

Git[1] 套件的一部分