Синтаксис шаблонов .gitignore: полный обзор

Каждая строка .gitignore — это один шаблон. Синтаксис похож на glob в командной оболочке, но смысл сильно зависит от положения слеша и положения **. Изложенное ниже опирается на официальную документацию git gitignore(5), а примеры проверены вручную в git 2.50.

Пустые строки, комментарии, экранирование

• Пустая строка ни с чем не совпадает. Её используют как разделитель для удобства чтения.
• Строка, начинающаяся с #, — комментарий. Чтобы игнорировать файл, имя которого начинается с #, поставьте перед ним обратный слеш: \#.
• Пробелы в конце строки игнорируются. Если нужно имя файла, оканчивающееся пробелом, защитите пробел обратным слешем, как в foo\ . Пробелы в начале строки остаются частью шаблона.
• Строка, начинающаяся с !, — отрицающий шаблон. Для файла, имя которого начинается с !, пишите \!important.txt.

Конечные пробелы невидимы и потому часто становятся причиной ошибок. Если правило не срабатывает, включите в редакторе отображение пробелов. Помните также, что удаляются только пробелы, а символы табуляции — нет.

Завершающий слеш: только каталоги

Если шаблон оканчивается на /, он совпадает только с каталогами. build/ игнорирует каталог build и всё его содержимое, но не файл с именем build. Напротив, build без слеша совпадает и с файлами, и с каталогами с таким именем.

Слеш фиксирует положение

Если в шаблоне, не считая завершающего слеша, есть / в начале или в середине, он совпадает только с путями относительно каталога, в котором лежит .gitignore. Это обычно называют привязкой (anchoring). Без / git ищет совпадающие имена на любой глубине ниже места расположения .gitignore.

Особенно путает третья строка. В logs/debug.log есть слеш в середине, поэтому шаблон привязан к корню и означает то же, что и с / в начале. Чтобы поймать logs/debug.log на любой глубине, используйте **/logs/debug.log.

Подстановочные знаки: *, ?, [ ]

• * совпадает с любой строкой, кроме / (включая пустую строку). *.log совпадает и с app.log, и с a/b/app.log, а logs/*.log — только с logs/app.log, но не с logs/2026/app.log.
• ? совпадает с одним любым символом, кроме /. file?.txt совпадает с file1.txt, но не с file10.txt.
• [a-z] совпадает с одним символом из диапазона, [!a-z] или [^a-z] — с одним символом вне диапазона. *.py[cod] сразу ловит .pyc, .pyo и .pyd. Квадратные скобки тоже не совпадают с /.
• Можно использовать и классы символов POSIX, например [[:digit:]].

Две звёздочки **

** имеет особый смысл только рядом со слешем.

В остальных позициях, например в foo** или **bar, ** ведёт себя как обычная * и не переходит через слеш. docs/**/*.pdf совпадает и с docs/manual.pdf, и с docs/a/b/manual.pdf, потому что /**/ совпадает и с нулём каталогов.

Итог на одном небольшом примере

# Результаты сборки (только каталог build в корне)
/build/

# Лог-файлы на любой глубине, но важный лог оставляем
*.log
!important.log

# Все PDF внутри docs
docs/**/*.pdf

# Файл, имя которого начинается с #
\#scratch.md

Эту таблицу можно воспроизвести, вставив правила и пути во вкладку Тест шаблонов генератора.

Источники

• Официальная документация gitignore (git-scm.com)
• GitHub Docs: Ignoring files
• Дата проверки: 2026-09-23 (примеры проверены в git 2.50.1)