Почему .gitignore не скрывает файл: две проверки без удаления

Добавили файл в .gitignore, а Git всё равно показывает его изменения? Частая причина: файл уже отслеживается. Правила игнорирования действуют на неотслеживаемые файлы и сами не убирают ранее добавленное из индекса.

Этот короткий разбор — для тех, у кого Git уже установлен на Windows, macOS или Linux. Для локальных проверок не нужны аккаунт, подписка или ИИ-сервис. Откройте терминал в корне своего репозитория и замените build/output.log точным относительным путём к одному файлу; путь с пробелами заключите в кавычки.

1. Проверить, отслеживается ли файл

git ls-files --error-unmatch -- build/output.log

Выведен путь — файл есть в индексе, то есть отслеживается. Сообщение о том, что путь не совпал с известными Git файлами, и код возврата 1 означают, что указанного файла в индексе нет. Проверьте написание пути. Ошибка «not a git repository» означает, что сначала нужно открыть правильную папку.

2. Найти правило, которое совпало с путём

git check-ignore -v --no-index -- build/output.log

Команда показывает файл правил, номер строки, правило и проверяемый путь. Флаг --no-index позволяет исследовать правила даже для отслеживаемого файла: он не удаляет файл из индекса. Если найденное правило начинается с !, это исключение из игнорирования, а не запрет. Если вывода нет и нет сообщения об ошибке, совпадающее правило не найдено.

Посмотрите, откуда взялось правило: оно может находиться во вложенном .gitignore или другом файле исключений. Путь в самом .gitignore считается относительно расположения этого файла; правило build/ и правило /build/ имеют разный охват.

Что дальше

Если файл отслеживается, переписывание одного .gitignore не решит задачу. Если не отслеживается — изучите найденное правило и его расположение. Обе команды только читают состояние: откат не нужен. Не удаляйте файлы и не очищайте индекс наугад.

.gitignore не стирает историю и не защищает уже раскрытые секреты. Не присылайте пароли, токены или содержимое личных файлов. Разбор сверен с официальной документацией; проверку в вашем проекте редакция не выполняла.

Что оказалось причиной у вас: файл уже отслеживался, правило не совпало или сработало другое правило? Можно ответить одним вариантом и, если нужно, добавить обезличенный путь и правило — без содержимого файла.

Проверяемые источники

• Git: правила gitignore
• Git: check-ignore
• Git: ls-files