如何从当前Git工作树中删除本地（未跟踪）文件

技术背景

在使用Git进行项目开发时，工作树中可能会出现一些未被Git跟踪的文件。这些文件可能是临时文件、生成的缓存文件或者误添加的文件。为了保持工作树的整洁，避免不必要的文件干扰，我们需要将这些未跟踪的文件删除。Git提供了多种方法来实现这一目的，下面将详细介绍。

实现步骤

1. 使用git clean命令

git clean是Git提供的专门用于清理工作树中未跟踪文件的命令。在使用该命令之前，建议先进行一次“干运行”，查看哪些文件会被删除，避免误删重要文件。

显示将要删除的文件

git clean -n -d

• -n 或 --dry-run：表示干运行，不会实际删除文件，只是显示哪些文件会被删除。
• -d：表示同时删除未跟踪的目录。

实际删除文件

git clean -f

• -f 或 --force：表示强制删除文件。如果Git配置变量clean.requireForce设置为true（默认值），则必须使用该选项才能实际删除文件。

删除未跟踪的目录

git clean -f -d 或 git clean -fd

删除被忽略的文件

git clean -f -X 或 git clean -fX

删除被忽略和未被忽略的文件

git clean -f -x 或 git clean -fx

2. 使用git add和git reset组合

git add --all
git reset --hard HEAD

这种方法先将所有未跟踪的文件添加到暂存区，然后将工作树重置到HEAD的状态，从而删除这些未跟踪的文件。

3. 使用git stash命令

git stash push -u
git stash drop "stash@{0}"

• -u 或 --include-untracked：表示将未跟踪的文件也存入stash。
• git stash drop "stash@{0}"：表示删除最新的stash。

核心代码

git clean命令示例

# 显示将要删除的文件
git clean -n -d
# 实际删除文件和目录
git clean -fd
# 删除被忽略和未被忽略的文件和目录
git clean -fdx

git add和git reset组合示例

git add --all
git reset --hard HEAD

git stash命令示例

git stash push -u
git stash drop "stash@{0}"

最佳实践

1. 先进行干运行

在使用git clean命令实际删除文件之前，一定要先使用-n选项进行干运行，确认哪些文件会被删除，避免误删重要文件。

2. 使用交互式模式

git clean -i提供了交互式模式，在删除文件之前会提示你确认是否删除每个文件，这样可以更好地控制删除操作。

3. 备份重要文件

在进行文件删除操作之前，建议先备份重要的未跟踪文件，以防误删。

常见问题

1. git clean命令不删除某些目录

如果未跟踪的目录是一个独立的Git仓库（例如子模块），默认情况下git clean不会删除该目录。可以使用-f选项两次来强制删除：

git clean -d -f -f

2. git clean删除了被忽略的文件

如果不想删除被忽略的文件，不要使用-x选项。-x选项会忽略.gitignore文件中的规则，删除所有未跟踪的文件，包括被忽略的文件。

3. git stash删除了不需要删除的文件

git stash push -u会将所有未跟踪的文件存入stash，如果不小心存入了不需要删除的文件，可以使用git stash pop或git stash apply来恢复这些文件。