
Содержание4 разделов
Добавленная строка в .gitignore не отменяет прежнее включение файла в Git. Если файл уже отслеживается, изменения продолжают появляться в status. Сначала выясните его состояние, затем проверяйте правило.
Команды ниже выполняют из корня обычного репозитория. Версию покажет git --version; параметры проверены по текущей документации Git 2.56. Сохраните копию важного файла до изменения индекса. Не применяйте массовое удаление ко всему проекту.
Как добавить файл или папку в .gitignore
Откройте или создайте текстовый файл с точным именем .gitignore в корне репозитория. Правила записывают по одному на строку. Учебный пример:
local-demo.txt
build-demo/
*.log
Первая строка задаёт имя файла, вторая обозначает каталог, третья подходит для имён с окончанием .log. Шаблоны действуют относительно расположения .gitignore по правилам Git; эти простые записи без начального слеша могут совпадать и во вложенных папках.
Сохраните .gitignore и проверьте конкретный путь командой ниже. Если файл уже добавлен в индекс, новое правило не уберёт его оттуда. Дальше нужно отдельно проверить отслеживание.
Почему .gitignore не игнорирует файл
Вместо local-demo.txt подставьте один нужный путь. Проверка индекса:
git ls-files -- local-demo.txt
Выведенный путь означает, что Git отслеживает файл. Пустой вывод для обычного существующего файла означает, что его нет в индексе. Это ещё не доказывает совпадение с правилом игнорирования.
git check-ignore -v --no-index -- local-demo.txt
Вторая команда рассматривает правила без исключения отслеживаемых файлов. В выводе видны файл правила, номер строки и шаблон. Если совпадение начинается с !, это отмена игнорирования. Пустой вывод означает, что совпавшего правила не показано.
Учебный пример: local-demo.txt ранее добавили через git add, а потом внесли в .gitignore. Первая команда показывает путь, вторая показывает подходящее правило. Противоречия нет: файл уже состоит на учёте, и правило для новых файлов этого не меняет.
Снимайте с учёта только нужный файл
Если команда должна хранить файл в репозитории, остановитесь и согласуйте изменение. Для личного локального файла, который решили исключить, сначала проверьте пробный запуск:
git rm -n --cached -- local-demo.txt
Потом выполните ту же команду без -n:
git rm --cached -- local-demo.txt
git status --short
Параметр —cached оставляет рабочий файл на диске и убирает его из индекса. Status покажет подготовленное удаление из следующего коммита. Проверьте файл в папке и список подготовленных изменений до коммита; правило .gitignore тоже должно войти в согласованную правку.
Если Git отказал из-за различий содержимого, не добавляйте -f автоматически. Сначала разберите сохранённые и подготовленные изменения. Для учебного опыта можно взять новый репозиторий с безобидным текстовым файлом.
Игнорирование не стирает прошлое
Эта правка не удаляет файл из старых коммитов. Если туда уже попал настоящий токен, отсутствие в новом status не делает токен закрытым. Нужны отзыв доступа и отдельная проверка истории, в соответствии с правилами проекта.
Проверки платформы разобраны в статье о поиске секретов GitHub. А .gitignore не ограничивает чтение файла программой или ИИ-агентом: для этого проверяют права и область работы инструмента.
AI-обложка иллюстрирует включённый в проект файл, без реальных секретов.
После проверки отслеживания файла посмотрите, какие правки подготовлены к коммиту: рабочая копия и индекс могут содержать разные версии.
Состояние отслеживания влияет и на временный снимок: обычный git stash оставляет новые файлы. Учебный пример сравнивает push с -u и показывает, что происходит с игнорируемым файлом после сохранения самого .gitignore.
На Mac файл с точкой в начале имени может быть скрыт в окне папки. Посмотрите, как показать скрытые файлы в Finder, прежде чем создавать второй .gitignore.
Источники

Как вам материал?



Комментарии