.gitignore не работает — Git продолжает видеть файл
Правила .gitignore действуют только на файлы, за которыми Git ещё не следит. Если файл уже был в коммите, Git продолжит его отслеживать, что бы ни было в .gitignore. Уберите файл из репозитория командой git rm --cached — в папке он останется.
Содержание 8
Что сделать прямо сейчас
- Проверьте, следит ли Git за файлом:
git ls-files .env— вместо .env подставьте свой файл. - Git ответил именем файла — он отслеживается: уберите его из репозитория.
- Ответ пустой — Git за файлом не следит, значит, не срабатывает правило: проверьте его.
Команды Git вводятся там, где лежит репозиторий: на сервере — после подключения по SSH (как подключиться), на своём компьютере — в Терминале (Mac) или в Git Bash (Windows).
Почему так
Справка Git говорит прямо: файлы, которые Git уже отслеживает, правила .gitignore не затрагивают. Задача .gitignore — чтобы неотслеживаемые файлы такими и остались. Если файл попал в коммит до того, как вы дописали правило, Git будет видеть в нём каждую правку.
Уберите файл из репозитория
Сначала допишите имя файла в .gitignore, если его там ещё нет. Затем:
git rm --cached .env
git add .gitignore
git commit -m "Убрать .env из репозитория"
git pushGit ответит rm '.env' — файл убран из репозитория, но остался в папке: ключ --cached не трогает файлы на диске. Для папки добавьте ключ -r: git rm -r --cached cache.
Что будет на сервере
В новом коммите файла нет, поэтому git pull на сервере удалит его из папки сайта. Если файл на сервере отличается от того, что был в репозитории, git pull остановится с ошибкой Your local changes would be overwritten.
Чтобы сохранить файл, перед git pull отложите его в домашнюю папку, а после верните. Команды вводятся в папке сайта на сервере:
mv .env ~/env-backup
git pull --no-rebase --no-edit
mv ~/env-backup .envПосле этого файл на месте, а Git на сервере его больше не видит: правило из .gitignore пришло вместе с коммитом.
Если Git не отслеживает файл, а правило не срабатывает
git check-ignore -v .envЕсли правило есть, Git покажет файл с правилом, номер строки, само правило и путь, например:
.gitignore:1:.env .envПустой ответ значит, что ни одно правило к файлу не подходит. Проверьте запись в .gitignore:
- Правило со знаком / в начале или в середине считается от папки, где лежит этот .gitignore:
/config.phpподходит только к файлу рядом с ним. Без / — к файлу с таким именем и рядом с .gitignore, и в любой вложенной папке. - Знак / в конце — правило только для папок:
cache/. - Строка с # в начале — комментарий.
- Правило с ! в начале делает исключение, но вернуть файл нельзя, если исключена вся папка, где он лежит.
Для отслеживаемого файла git check-ignore ничего не покажет: правила на него не действуют. Увидеть, какое правило сработало бы, поможет ключ --no-index: git check-ignore -v --no-index .env.
Как проверить
git ls-files .envПустой ответ — Git больше не следит за файлом. В ответе git status файла тоже нет.
Источники
- Справка gitignore — правила шаблонов и что делать, если файл уже отслеживается.
- Справка git check-ignore — ключи -v и --no-index.
- Справка git rm — ключ --cached.
- Исходный код Git 2.43.0: builtin/rm.c — строка rm '…'.
- Справка git ls-files — список файлов, которые отслеживает Git.
- Пакет git в Ubuntu 24.04 — версия 2.43.0, с ней сверены тексты сообщений.
Сверено 20 октября 2026 года.
Что почитать дальше
- Your local changes would be overwrittenесли git pull на сервере не даёт обновить файл.
- nothing to commitесли git commit не видит изменений.
- Все ошибки Gitтаблица сообщений со ссылками на разборы.
- .gitignoreчто вписать и как проверить правило.