如何理解 Any untracked files or directories in the way of writing any tracked files are simply deleted

git reset 命令有个 --hard 选项，描述如下：

--hard
Resets the index and working tree. Any changes to tracked files in the working tree since are discarded. Any untracked files or directories in the way of writing any tracked files are simply deleted.

让我们从 a tracked file 的定义开始，它非常简单：A tracked file is a file that is in Git’s index 。这样的文件有一个名称，例如 path/to/file.ext 。请注意，这里没有目录或文件夹这回事，它只是一个长名称，带有正斜杠，即使主机操作系统（Windows）要调用这个 path\to\file.ext ，它也总是带有正斜杠。

那么，简单的答案就是观察 Git 将把 path/to/file.ext 写入到你的工作树中，因为 path/to/file.ext 在Git的 index 中，git reset --hard 因此需要写入 path\to\file.ext（Windows）或 path/to/file.ext（其他操作系统）。要做到这一点，path 必须是一个目录（AKA文件夹），使用的 path/to 或 path\to 也必须是文件夹。

因此，如果有一个名为 path 或 path/to 的现有文件，Git 会删除这个文件（只会有一个，因为这些操作系统认为，一些路径名要么被识别为文件，要么被识别为文件夹，或者，至少在类 Unix 系统上，可以被识别为 fifos 、devices 和 sockets 等特殊项目，但无论哪种方式，它都会碍事的）。这就是你引用的短语的意思的简单答案。

下面有两个例子可以说明这一点：

第一个例子，先在工作树中创建一个文件，并保持未跟踪状态：

echo data > some-file

运行 git status 会将其显示为 untracked (例如，在 git status -s 输出中会显示 ?? some-file )。正如您已经看到的，git reset --hard 不会改变这一点。

现在使用以下方法将文件复制到Git的 index 中：

git add some-file

现在 git status 将显示为一个要 commit 的新文件。它不在当前 (HEAD) commit 中，所以执行 diff 从 HEAD commit 到 index 将显示 some-file 是新的。它同时存在于 Git 的 index 和您的工作树中，所以执行 diff 从 index 到工作树 则不会显示任何信息。

接下来运行：

git reset --hard

其重置为当前 commit 。这使得Git将文件 some-file 从其 index 中剥离出来，因为一个名为 some-file 的文件现在位于 Git 的 index 中，但它不在（新选择的）HEAD commit 中（“佯装无意地” “恰好”与之前的 HEAD commit 相同，因为我们没有选择其他 commit ）。我们在做这件事的时候使用了 --hard ，所以 Git 同时删除了 index 与 工作区的这个文件。

第二个例子，git reset --hard 会对 untracked 文件产生影响：

touch a.txt
git add .
git commit -m'init'

echo hello >> a.txt
git add .
git commit -m'hello'

git rm a.txt
echo world > a.txt
git status -s

status 的输出会是：

D  a.txt
?? a.txt

index 中的 a.txt 被删除，而工作树中的 a.txt 则是 untracked 。

cat a.txt
world

然后再用 --hard 模式进行重置：

git reset --hard
cat a.txt
hello

git status
On branch master
nothing to commit, working tree clean

工作树中未跟踪的 a.txt 文件将被删除。但我们也可以说它被 HEAD 中跟踪的 a.txt 文件覆盖了。