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

技术背景

在使用Git进行版本控制时，工作树中可能会存在未被Git跟踪的文件，这些文件可能是临时文件、构建产物等。为了保持工作树的整洁，需要移除这些未跟踪的文件。git clean 命令就是专门用于移除工作树中未跟踪文件的工具。

实现步骤

1. 查看将被删除的文件

在执行实际删除操作之前，建议先使用 -n 选项查看哪些文件将被删除，这是一个安全的预演步骤。

# 打印出将被移除的文件和目录列表（预演）
git clean -n -d

2. 执行删除操作

根据不同的需求，选择合适的选项进行删除。

• 删除文件：

# 从仓库中删除文件
git clean -f

• 删除文件和目录：

git clean -f -d 或 git clean -fd

• 删除被忽略的文件：

git clean -f -X 或 git clean -fX

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

git clean -f -x 或 git clean -fx

3. 交互式删除

使用 -i 选项可以进入交互式模式，在删除文件前进行确认。

git clean -i -fd

4. 使用stash移除未跟踪文件

如果不确定删除是否安全，可以使用 git stash 命令。

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

核心代码

以下是一些常用的 git clean 命令组合：

# 删除文件和目录
git clean -fd
# 删除文件、目录和被忽略的文件
git clean -fdx
# 预演删除操作
git clean -n -fd
# 交互式删除文件和目录
git clean -i -fd

最佳实践

• 使用 -n 选项预演：在执行实际删除操作前，使用 -n 选项查看哪些文件将被删除，避免误删重要文件。
• 谨慎使用 -x 选项：-x 选项会删除被忽略的文件，可能会导致构建产物、IDE 设置等丢失，使用前要确保了解其影响。
• 使用交互式模式：对于不确定是否要删除的文件，可以使用 -i 选项进入交互式模式，逐个确认删除操作。

常见问题

1. git clean 拒绝执行

如果 clean.requireForce 配置项设置为 true（默认值），则需要指定 -f、-n 或 -i 选项，否则 git clean 不会执行。

2. 嵌套Git仓库无法删除

如果未跟踪的目录是一个独立的Git仓库，默认情况下不会被删除。可以使用两次 -f 选项强制删除：

git clean -d -f -f

3. 只想删除特定子目录中的未跟踪文件

可以指定目录路径：

git clean -f {dir_path}