Поиск
Справочник

git clean: удалить лишние файлы из папки сайта

В папке сайта со временем копятся файлы, которых нет в репозитории: старые копии, временные файлы, то, что загрузили на сервер руками. Команда git clean удаляет их разом. Но вместе с мусором она может удалить и нужное — настройки или загрузки. Здесь — как сначала посмотреть список и удалить только лишнее.

≈ 3 мин чтения
Содержание 7

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Перейдите в папку сайта: cd /var/www/example.com. Вместо /var/www/example.com — папка вашего сайта.
  3. Посмотрите, что Git удалит, — сама команда ничего не удаляет:
    git clean -n -d
    Would remove new.txt
    Would remove tmpdir/
  4. Если в списке есть нужные файлы — например .env или папка загрузок, — сначала впишите их в .gitignore (.gitignore) и повторите шаг 3.
  5. Когда в списке только лишнее, удалите:
    git clean -f -d

    Ответ: Removing new.txt и Removing tmpdir/ — файлы удалены.

Удалённые командой git clean файлы не попадают в корзину и не восстанавливаются: их не было в репозитории. Начинайте с -n.

Ключи

КлючЧто делает
-nтолько показать, что будет удалено
-fудалить; без него Git откажется и напишет refusing to clean
-dудалять и папки, которых нет в репозитории; без него — только файлы
-xудалять и файлы из .gitignore

Без -d команда git clean -n покажет только файлы: Would remove new.txt, а папку tmpdir/ пропустит.

Только в одной папке — укажите её в конце: git clean -n -d cache/.

Что git clean не трогает

  • Файлы из репозитория: правки в них убирает git restore.
  • Файлы и папки из .gitignore, пока нет ключа -x.

Поэтому .env, wp-config.php, журналы и загрузки держите в .gitignore: тогда git clean -f -d их не удалит.

Не запускайте на сервере сайта git clean -f -d -x: он удалит и файлы из .gitignore — настройки с паролями, загрузки, журналы. Проверьте сами: git clean -n -d -x покажет их в списке.

Если файл мешает git pull

Если на сервере есть файл, которого нет в репозитории, а в репозитории появился файл с тем же именем, git pull остановится:

error: The following untracked working tree files would be overwritten by merge:
	sitemap.xml
Please move or remove them before you merge.
Aborting

Файлы при этом не меняются. Перенесите файл в сторону и повторите обновление:

mv sitemap.xml ~/sitemap.xml.bak
git pull

Если нужно, сравните потом свой файл с новым: diff ~/sitemap.xml.bak sitemap.xml. Когда всё в порядке, удалите копию: rm ~/sitemap.xml.bak.

Файлов много — перенесите каждый из списка в ошибке или, если ни один не нужен, удалите их командой git clean -f с именами файлов в конце.

Ошибки и как их исправить

Что видитеПричинаЧто делать
refusing to cleanнет ключа -f или -ngit clean -n -d, затем git clean -f -d
error: The following untracked working tree files would be overwritten by merge:на сервере есть файл с именем, которое пришло из репозиториявыше
после git clean пропал .env или загрузкиих не было в .gitignore или был ключ -xвосстановите из резервной копии и впишите в .gitignore
git clean -n не показывает папкунет ключа -dgit clean -n -d
fatal: not a git repositoryкоманда запущена не в папке сайтаразбор

Команды и ответы проверены в Git 2.54; в Ubuntu 24.04 стоит Git 2.43.0 — все команды страницы в нём есть.

Источники

Сверено 9 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше

  • .gitignoreкакие файлы Git не должен трогать.
  • git statusкак увидеть лишние файлы.
  • Команды Gitвсе команды на одной странице.