Поиск
Ошибки

.gitignore не работает — Git продолжает видеть файл

Правила .gitignore действуют только на файлы, за которыми Git ещё не следит. Если файл уже был в коммите, Git продолжит его отслеживать, что бы ни было в .gitignore. Уберите файл из репозитория командой git rm --cached — в папке он останется.

≈ 4 мин чтения
Содержание 8

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

  1. Проверьте, следит ли Git за файлом: git ls-files .env — вместо .env подставьте свой файл.
  2. Git ответил именем файла — он отслеживается: уберите его из репозитория.
  3. Ответ пустой — 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 push

Git ответит 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 файла тоже нет.

Источники

Сверено 20 октября 2026 года.

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

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