Русский ▾ 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 не имеет значения; все неотслеживаемые файлы, соответствующие указанным путям (с исключениями для вложенных каталогов Git, упомянутых в --force), будут удалены.

-f
--force

Если переменная конфигурации Git clean.requireForce не установлена в false, git clean откажется удалять файлы или каталоги, если только не указан -f. Git откажется изменять неотслеживаемые вложенные репозитории Git (каталоги с подкаталогом .git), если только не указан второй -f.

-i
--interactive

Показать, что будет сделано, и интерактивно очистить файлы. Подробности см. в разделе «Интерактивный режим». Переменная конфигурации clean.requireForce игнорируется, так как этот режим обеспечивает собственную защиту, переходя в интерактивный режим.

-n
--dry-run

Фактически ничего не удалять, просто показать, что было бы сделано. Переменная конфигурации clean.requireForce игнорируется, так как всё равно ничего не будет удалено.

-q
--quiet

Работать тихо, сообщать только об ошибках, но не о файлах, которые были успешно удалены.

-e <шаблон>
--exclude=<шаблон>

Использовать указанный шаблон исключения в дополнение к стандартным правилам игнорирования (см. gitignore[5]).

-x

Не использовать стандартные правила игнорирования (см. gitignore[5]), но по-прежнему использовать правила игнорирования, заданные с помощью параметров -e в командной строке. Это позволяет удалить все неотслеживаемые файлы, включая артефакты сборки. Это можно использовать (возможно, в сочетании с git restore или git reset) для создания чистого рабочего каталога для тестирования чистой сборки.

-X

Удалять только файлы, игнорируемые Git. Это может быть полезно для перестроения всего с нуля, но при этом сохранить созданные вручную файлы.

Интерактивный режим

Когда команда переходит в интерактивный режим, она показывает файлы и каталоги для очистки и входит в свой интерактивный командный цикл.

Цикл команд показывает список доступных подкоманд и приглашение "Что теперь> ". Обычно, когда приглашение заканчивается одним символом >, вы можете выбрать только один из предложенных вариантов и нажать Enter, например:

    *** Команды ***
	1: clean                2: filter by pattern    3: select by numbers
	4: ask each             5: quit                 6: help
    Что сейчас> 1

Вы также можете ввести c или clean выше, если выбор уникален.

Главный цикл команд имеет 6 подкоманд.

очистить

Начать очистку файлов и каталогов, а затем выйти.

filter by pattern

Это показывает файлы и каталоги, подлежащие удалению, и выводит приглашение «Введите шаблоны игнорирования>>». Вы можете ввести разделённые пробелами шаблоны, чтобы исключить файлы и каталоги из удаления. Например, «*.c *.h» исключит из удаления файлы, оканчивающиеся на «.c» и «.h». Когда вы будете довольны отфильтрованным результатом, нажмите ENTER (пустой ввод), чтобы вернуться в главное меню.

select by numbers

Это показывает файлы и каталоги для удаления и выводит приглашение "Выберите элементы для удаления>>". Когда приглашение заканчивается двойным >>, вы можете сделать более одного выбора, разделяя их пробелом или запятой. Также вы можете указывать диапазоны. Например, "2-5 7,9" для выбора 2,3,4,5,7,9 из списка. Если второе число в диапазоне опущено, выбираются все оставшиеся элементы. Например, "7-" для выбора 7,8,9 из списка. Вы можете ввести * для выбора всего. Когда вас устраивает отфильтрованный результат, нажмите ENTER (пустой ввод) для возврата в главное меню.

ask each

Это начнёт очистку, и вы должны подтверждать каждый элемент по отдельности, чтобы удалить его. Обратите внимание, что это действие не так эффективно, как два вышеуказанных действия.

выйти

Это позволяет выйти без выполнения какой-либо очистки.

справка

Показать краткое использование интерактивного git-clean.

КОНФИГУРАЦИЯ

Дальнейшее содержание этого раздела, повторяет то, что может быть найдено в git-config[1]:

Warning

Missing ru/config/clean.adoc

See original version for this content.

СМ. ТАКЖЕ

gitignore[5]

GIT

Является частью пакета git[1]