Перейти к содержимому

СофтРазбор

Как добавить файл в .gitignore и почему он не работает

Как добавить файл или папку в .gitignore, проверить правило и убрать один отслеживаемый файл из индекса Git, сохранив рабочую копию на диске.

Иллюстрация: Как добавить файл в .gitignore и почему он не работает
Содержание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.

Птичка messgo спрашивает, как вам материал

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

Поделиться

Читайте также

Комментарии

Написать комментарий

Без регистрации: имя и почта не нужны, мы подпишем вас случайным именем. Комментарий появится после проверки редакцией.