.gitignore: какие файлы сайта Git не должен трогать
В файле .gitignore перечислено, что Git не должен добавлять в репозиторий: настройки с паролями, загрузки посетителей, журналы, кэш. Эти файлы живут только на сервере. Если они вписаны в .gitignore, их не удалят команды git clean -f -d и git stash -u. Здесь — что вписать, как проверить правило и что делать, если файл уже попал в репозиторий.
Содержание 8
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Перейдите в папку сайта:
cd /var/www/example.com. Вместо/var/www/example.com— папка вашего сайта. - Откройте файл:
nano .gitignore(редактор nano). Если файла нет, nano создаст его. - Впишите по одному правилу в строке, например для WordPress:
wp-config.php .env wp-content/uploads/ wp-content/cache/ *.log - Сохраните: Ctrl+O, Enter, затем Ctrl+X.
- Проверьте, что правила работают:
git check-ignore -v wp-config.php error.log.gitignore:1:wp-config.php wp-config.php .gitignore:5:*.log error.logВ строке — файл с правилами, номер строки, само правило и закрытый файл. Нет строки для файла — он не закрыт.
.gitignore уже есть в репозитории, правку сделайте в репозитории, а на сервере выполните git pull. Правка только на сервере покажет в git status строку M .gitignore, и следующий git pull может остановиться на этом файле. Правила только для сервера пишите в .git/info/exclude — ниже.Как писать правила
| Правило | Что закрывает |
|---|---|
wp-config.php | файл с этим именем в любой папке сайта |
/wp-config.php | только файл в корне папки сайта |
wp-content/uploads/ | папку загрузок со всем, что в ней |
*.log | все файлы, имя которых заканчивается на .log |
!keep.log | исключение: этот файл не закрывать, хотя есть *.log |
# комментарий | пояснение, Git эту строку пропускает |
Если git check-ignore -v выводит правило с !, файл не закрыт: сработало исключение.
Проверить, что закрыто
git status --ignored -s!! .env
!! error.log
!! wp-config.php
!! wp-content/!! — файл или папка закрыты правилами. Без --ignored команда git status их не показывает (git status).
Если попробовать добавить закрытый файл:
git add .envThe following paths are ignored by one of your .gitignore files:
.envФайл не добавлен — так и задумано. git add . закрытые файлы пропускает молча. Ключ -f (git add -f .env) добавит файл, несмотря на правило: с файлами, где лежат пароли, так не делайте.
Правила только для сервера
Файл .git/info/exclude пишется так же, как .gitignore, но в репозиторий не попадает и git pull его не меняет. Сюда — то, что есть только на этом сервере: копии, архивы, файлы проверки домена.
nano .git/info/excludeВпишите правило в конце файла, например backup.zip, и проверьте:
git check-ignore -v backup.zip.git/info/exclude:7:backup.zip backup.zipЕсли файл уже в репозитории
Правило не действует на файлы, которые уже есть в репозитории: Git по-прежнему показывает их правки в git status, а git check-ignore -v для них ничего не выводит. Проверьте: git ls-files wp-config.php — если Git вывел имя, файл в репозитории.
Убрать файл из репозитория и оставить его на диске:
- В папке, где вы делаете коммиты:
git rm --cached wp-config.phpОтвет:
rm 'wp-config.php'. Файл остался в папке, аgit status -sпоказываетD wp-config.php— из репозитория он уйдёт со следующим коммитом. - Сделайте коммит и отправьте его в репозиторий:
git commit -m "wp-config.php в .gitignore", затемgit push.
git pull удалит файл из папки сайта: для Git файл удалён из репозитория. Перед git pull сохраните копию — cp wp-config.php ~/wp-config.php.bak, — после верните: cp ~/wp-config.php.bak wp-config.php. Если файл уже пропал, сразу после git pull достаньте его из прошлой версии: git show ORIG_HEAD:wp-config.php > wp-config.php, затем проверьте права файла (права на файлы сайта). Подробнее — разбор.git rm --cached. Смените его.Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
правило вписано, а git status показывает правки файла | файл уже в репозитории | выше, разбор |
The following paths are ignored by one of your .gitignore files: | файл закрыт правилом | так и задумано; какое правило — git check-ignore -v имя-файла |
после git pull пропал wp-config.php или .env | файл убрали из репозитория командой git rm --cached | git show ORIG_HEAD:wp-config.php > wp-config.php (выше) |
M .gitignore в git status | .gitignore правили на сервере | перенесите правку в репозиторий, на сервере git restore .gitignore и git pull; правила для сервера — в .git/info/exclude |
fatal: pathspec 'wp-content/' did not match any files при git rm --cached -r wp-content/ | папки нет в репозитории | ничего делать не нужно: Git её и так не хранит |
Команды и ответы проверены в Git 2.54; в Ubuntu 24.04 стоит Git 2.43.0 — все команды страницы в нём есть.
Источники
- Документация Git: gitignore — на английском: как пишутся правила,
!,/и.git/info/exclude. - Документация Git: git check-ignore — на английском: ключ -v и формат ответа.
Сверено 9 ноября 2026 года.
Что почитать дальше
- git cleanкак удалить лишние файлы и не задеть закрытые.
- git stashпочему
git stash -uможет убрать.env. - Команды Gitвсе команды на одной странице.