git clean: удалить лишние файлы из папки сайта
В папке сайта со временем копятся файлы, которых нет в репозитории: старые копии, временные файлы, то, что загрузили на сервер руками. Команда git clean удаляет их разом. Но вместе с мусором она может удалить и нужное — настройки или загрузки. Здесь — как сначала посмотреть список и удалить только лишнее.
Содержание 7
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Перейдите в папку сайта:
cd /var/www/example.com. Вместо/var/www/example.com— папка вашего сайта. - Посмотрите, что Git удалит, — сама команда ничего не удаляет:
git clean -n -dWould remove new.txt Would remove tmpdir/ - Если в списке есть нужные файлы — например
.envили папка загрузок, — сначала впишите их в.gitignore(.gitignore) и повторите шаг 3. - Когда в списке только лишнее, удалите:
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 или -n | git 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 не показывает папку | нет ключа -d | git clean -n -d |
fatal: not a git repository | команда запущена не в папке сайта | разбор |
Команды и ответы проверены в Git 2.54; в Ubuntu 24.04 стоит Git 2.43.0 — все команды страницы в нём есть.
Источники
- Документация Git: git clean — на английском: ключи -n, -f, -d и -x.
Сверено 9 ноября 2026 года.
Что почитать дальше
- .gitignoreкакие файлы Git не должен трогать.
- git statusкак увидеть лишние файлы.
- Команды Gitвсе команды на одной странице.