Почему .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 на свежие ключи, находят такое за минуты.
Поэтому порядок действий такой:
- Отзови и перевыпусти ключ. Прямо сейчас, до всего остального. Старый должен перестать работать.
- Убери файл из индекса (
git rm --cached .env). - Пропиши
.envв.gitignoreи закоммить. - Положи в репозиторий
.env.example— только имена переменных, без значений.
Переписывать историю можно, но это отдельная операция с последствиями для всех, кто клонировал репозиторий, — и она всё равно не отменяет пункт 1. Подробности про хранение — в разборе, как безопасно хранить API-ключи, а зачем вообще нужны переменные окружения — рядом.
Почему ИИ-агент постоянно коммитит лишнее?
Потому что он выполняет git add ., а этот . тянет всё, что Git считает своим — включая уже отслеживаемые файлы, которые «вроде в игноре». Лечится не промптом, а состоянием репозитория: убери лишнее из индекса один раз, и агент физически не сможет его добавить.
Нужно ли коммитить сам файл .gitignore?
Да, обязательно. .gitignore — часть проекта: он должен приехать вместе с кодом к любому, кто склонирует репозиторий, иначе у коллеги правила просто не будет. Личные исключения, которые не касаются команды (файлы твоего редактора, локальные заметки), держи в глобальном игноре или в .git/info/exclude — они не уезжают в репозиторий.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





