Гайды

Почему .gitignore не работает — и почему .env всё равно уехал на GitHub

Иллюстрация: на дверь повесили табличку «не входить», а гость уже сидит внутри

Ты добавил .env в .gitignore. Сделал коммит. Открываешь репозиторий на GitHub — а он там. Лежит, светит ключами.

Первая мысль: «.gitignore сломан». Он не сломан. Он делает ровно то, что умеет, и не делает того, чего ты от него ждёшь.

Вот фраза, которая объясняет девять случаев из десяти:

.gitignore не прячет файлы. Он только мешает добавить новые.

Если файл уже попал в Git — хоть один раз, хоть месяц назад, — правила игнора на него больше не действуют. Совсем. Он теперь «свой», а игнор работает только с чужаками.

Сначала — одна команда, которая называет виновника

Не гадай. Спроси у Git напрямую:

git check-ignore -v .env

Три исхода:

  • Напечаталась строка вида .gitignore:3:.env .env — правило нашлось и работает. Значит, дело не в правиле, иди к причине 1.
  • Не напечаталось ничего — Git не видит подходящего правила. Иди к причине 2.
  • Напечаталось не то правило, которое ты ждал — тебя перебил другой файл или другая строка. Причина 3.

Полминуты — и ты знаешь, куда смотреть. Дальше по порядку.

Причина 1. Файл уже отслеживается

Самая частая, с огромным отрывом. Проверяется так:

git ls-files | grep .env

Если имя напечаталось — файл в индексе, и .gitignore тут бессилен.

Как чинить. Убрать файл из-под наблюдения Git, оставив на диске:

git rm --cached .env
git commit -m "stop tracking .env"

Ключевое здесь — --cached: он вычёркивает файл из Git, но не удаляет его у тебя. Без этого флага ты сотрёшь настоящий файл, и вечер будет испорчен.

Если насорено по-крупному (например, уехала папка node_modules), проще пересобрать индекс целиком:

git rm -r --cached .
git add .
git commit -m "apply gitignore"

Git выкидывает всё из индекса и набирает заново — теперь уже с оглядкой на .gitignore. Файлы на диске не трогаются.

Причина 2. Правило написано не так, как ты думаешь

check-ignore промолчал — значит, шаблон не совпадает. Классика:

  • logs и logs/ — разное. Первое игнорит и файл, и папку с таким именем. Второе — только папку.
  • Слэш в начале привязывает к корню. /config.json — только в корне репозитория. config.json — на любом уровне.
  • Слэш в середине убирает рекурсию. build/*.log — только в build. А просто *.log ловит логи на всех уровнях.
  • Пробел в конце строки. Невидим и ломает совпадение. Мучительная штука: глазами не найдёшь.

Как чинить. Правь шаблон и после каждой правки перепроверяй тем же git check-ignore -v. Не «сделаю коммит и посмотрю на GitHub» — команда отвечает мгновенно.

Причина 3. Правило есть, но побеждает другое

.gitignore в проекте может быть не один. Git читает их сверху вниз: корневой, потом файлы в подпапках, плюс твой личный глобальный (core.excludesFile) и внутренний .git/info/exclude. При конфликте побеждает последнее совпавшее правило.

Отсюда две ловушки.

Первая — порядок строк. Написал *.log, а ниже !important.log — файл вернётся в индекс. Поменял местами — не вернётся.

Вторая тоньше и ломает планы чаще: нельзя вернуть файл, если исключена вся папка над ним. Вот это не сработает:

secrets/
!secrets/example.env

Git не заходит внутрь исключённой папки, поэтому про example.env он просто не узнаёт. Правильно исключать содержимое, а не саму папку:

secrets/*
!secrets/example.env

Как чинить. Вывод git check-ignore -v печатает имя файла правил и номер строки — там и правь. Он же показывает, если тебя перебил глобальный игнор, о котором ты давно забыл.

Если это был .env — почини ещё и ключ

Тут неприятное. git rm --cached убирает файл из будущих коммитов, но история остаётся историей. Ключ, который однажды уехал в публичный репозиторий, лежит в старом коммите и открывается по прямой ссылке. Боты, сканирующие GitHub на свежие ключи, находят такое за минуты.

Поэтому порядок действий такой:

  1. Отзови и перевыпусти ключ. Прямо сейчас, до всего остального. Старый должен перестать работать.
  2. Убери файл из индекса (git rm --cached .env).
  3. Пропиши .env в .gitignore и закоммить.
  4. Положи в репозиторий .env.example — только имена переменных, без значений.

Переписывать историю можно, но это отдельная операция с последствиями для всех, кто клонировал репозиторий, — и она всё равно не отменяет пункт 1. Подробности про хранение — в разборе, как безопасно хранить API-ключи, а зачем вообще нужны переменные окружения — рядом.

Почему ИИ-агент постоянно коммитит лишнее?

Потому что он выполняет git add ., а этот . тянет всё, что Git считает своим — включая уже отслеживаемые файлы, которые «вроде в игноре». Лечится не промптом, а состоянием репозитория: убери лишнее из индекса один раз, и агент физически не сможет его добавить.

Нужно ли коммитить сам файл .gitignore?

Да, обязательно. .gitignore — часть проекта: он должен приехать вместе с кодом к любому, кто склонирует репозиторий, иначе у коллеги правила просто не будет. Личные исключения, которые не касаются команды (файлы твоего редактора, локальные заметки), держи в глобальном игноре или в .git/info/exclude — они не уезжают в репозиторий.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →