Git
简体中文 ▾ Topics ▾ Latest version ▾ git-clean last updated in 2.45.0

名称

git-clean - 删除工作目录树中未跟踪的文件

概述

git clean [-d] [-f] [-i] [-n] [-q] [-e <模式>] [-x | -X] [--] <路径规范>…​

描述

从当前目录开始,通过递归删除不在版本控制之下的文件来清理工作区。

通常情况下,只有 Git 未知的文件会被删除,但如果指定了 -x 选项,被忽略的文件也会被删除。例如,这对删除所有构建产品很有用。

如果给出任何可选的`<路径规范>…​`参数,只有那些与路径规范相匹配的路径会受到影响。

选项

-d

通常,当没有指定 <路径规范> 时,git clean 不会递归到未追踪的目录,以避免删除太多。 指定 -d 可以让它也递归到这些目录。 如果指定了<路径规范>,-d 就不重要了;所有符合指定路径的未追踪文件(--force 下提到的嵌套的 git 目录除外)将被删除。

-f
--force

If the Git configuration variable clean.requireForce is not set to false, git clean will refuse to delete files or directories unless given -f. Git will refuse to modify untracked nested git repositories (directories with a .git subdirectory) unless a second -f is given.

-i
--interactive

显示将要执行的操作,并交互式清理文件。详情请参 ``交互模式``。配置变量 clean.requireForce 被忽略,因为此模式通过进入交互式提供自己的安全保护。

-n
--dry-run

实际上不删除任何东西,只是显示将要执行的操作。配置变量 clean.requireForce 被忽略,因为无论如何都不会删除任何内容。

-q
--quiet

要安静,只报告错误,但不报告成功删除的文件。

-e <模式>
--exclude=<模式>

在标准的忽略规则之外,使用给定的排除模式(见 gitignore[5])。

-x

不要使用标准的忽略规则(见gitignore[5]),但仍然使用命令行中用 -e 选项给出的忽略规则。 这允许删除所有未跟踪的文件,包括构建产品。 这可以用来(可能与 git restoregit reset 一起使用)创建一个原始的工作目录来测试一个干净的构建。

-X

只删除被 Git 忽略的文件。 这对于从头开始重建一切,但保留手动创建的文件可能很有用。

交互模式

当命令进入交互式模式时,它会显示要清理的文件和目录,并进入其交互式命令循环。

命令循环显示可用的子命令列表,并提示 "What now>"。通常,当提示以单个 > 结尾时,您只能选择给定的一个选项并键入回车,如下所示:

    *** Commands ***
	1: clean                2: filter by pattern    3: select by numbers
	4: ask each             5: quit                 6: help
    What now> 1

你也可以在上面输入 cclean,只要选择是唯一的。

主命令循环有 6 个子命令。

清理

开始清理文件和目录,然后退出。

按模式过滤

这将显示要删除的文件和目录,并发出 "Input ignore patterns>>(输入忽略模式)" 提示。你可以输入以空格分隔的模式来排除文件和目录的删除。 例如,"*.c *.h " 将排除以 ".c " 和 ".h" 结尾的文件不被删除。当你对过滤后的结果满意时,按回车(空)键回到主菜单。

按数字选择

这显示了要删除的文件和目录,并发出 "Select items to delete>>(选择要删除的项目)"提示。当提示像这样以双 >> 结束时,你可以做一个以上的选择,用空格或逗号连接起来。 你也可以说范围。 例如,"2-5 7,9" 可以从列表中选择 2,3,4,5,7,9。 如果一个范围内的第二个数字被省略了,所有剩下的项目都会被选中。 例如:"7-" 从列表中选择 7、8、9。 你可以输入 * 来选择所有项目。 另外,当你对过滤后的结果满意时,按回车(空)键回到主菜单。

逐一询问

这将开始进行清理,你必须逐一确认,以便删除项目。请注意,这个动作没有上述两个动作那么有效。

退出

这样,您就可以在不做任何清洁的情况下退出。

帮助

显示交互式 git-clean 的简要用法。

配置

Warning

Missing zh_HANS-CN/includes/cmd-config-section-all.txt

See original version for this content.

Warning

Missing zh_HANS-CN/config/clean.txt

See original version for this content.

参见

GIT

属于 git[1] 文档

scroll-to-top