Ключові поняття

Файл .gitignore

В Git файл .gitignore — це текстовий файл, який каже Git, які файли й директорії ігнорувати під час відстеження змін у репозиторії. Через .gitignore можна виключити файли, які генеруються під час збірки, містять чутливу інформацію або не стосуються проєкту.

Де розмістити файл

  1. Корінь репозиторію: файл .gitignore варто класти в кореневу директорію репозиторію. Так Git застосує правила ігнорування до всіх файлів і директорій у репозиторії.

  2. Піддиректорії: файли .gitignore можна створювати й у піддиректоріях, щоб задати правила ігнорування, які діють лише на файли в цій директорії та її піддиректоріях.

Глобальний файл ігнорування

Крім файла ігнорування у проєкті, Git використовує ще й глобальний, який діє на всі репозиторії у твоїй системі. Шлях до глобального файла ігнорування зберігається у змінній конфігурації core.excludesFile.

Дізнайся, де лежить глобальний файл ігнорування:

git config --global core.excludesFile

Приклад

Файл: .gitignore
# Додавай коментарі для ясності. Коментар починається з символу решітки (#).
# Це коментар!
 
# Ігноруємо файли з конкретними іменами.
Thumbs.db
.DS_Store
 
# Ігноруємо файли з конкретними розширеннями. Зірочка (*) — це маска,
# яка відповідає будь-яким символам.
*.log
*.tmp
*.bak
 
# Ігноруємо директорії. Скісна риска в кінці не обов'язкова, але вона
# чіткіше показує читачеві, що це директорія.
logs
temp/
 
# Ігноруємо файли з конкретним іменем у будь-якій директорії.
# Шаблон ** відповідає будь-якій директорії, включно з піддиректоріями.
**/build/
 
# Ігноруємо файли з конкретним іменем у конкретній директорії.
docs/*.pdf
 
# Ігноруємо всі файли в директорії, крім одного конкретного файла.
# Префікс ! інвертує шаблон, тож файл не ігнорується.
config/*
!config/main.conf
 
# Повертаємо раніше проігнорований файл через префікс !.
!important.log