Що робить інструмент
Генератор .gitignore збирає файл .gitignore для вашого репозиторію з готових шаблонів. Виберіть мови, фреймворки, інструменти збирання, ігрові рушії, редактори й операційні системи проєкту, і інструмент об’єднає їхні правила в один файл із заголовком ### Назва ### для кожного розділу — його можна одразу скопіювати або завантажити.
У комплекті близько шістдесяти шаблонів із колекції github/gitignore: Node.js, Python, Java, Go, Rust, .NET, Swift, PHP-фреймворки Laravel і Symfony, Next.js, Flutter, Android, Terraform, Unity, Unreal Engine, Godot, VS Code, IDE від JetBrains, Vim, Emacs, macOS, Windows, Linux та інші. Усе виконується в браузері, жодні запити не надсилаються.
Як користуватися
- Натискайте на шаблони в списку, щоб додати їх. Пошук розуміє й поширені синоніми: «typescript» знайде Node.js, «intellij» — JetBrains.
- Вибрані шаблони показуються вгорі у вигляді міток у порядку вибору, і файл дотримується цього порядку. Натисніть на мітку, щоб прибрати її, або Очистити, щоб почати знову.
- Записи, потрібні лише вашому проєкту, додайте в Власні правила через кому, наприклад
.env, /dist, *.local. Вони потраплять у кінець, у розділ### Custom ###. - Вирішіть, чи зберігати пояснювальні коментарі шаблонів і чи прибирати правила, які вже є в попередньому шаблоні.
- Скопіюйте результат або завантажте його. Завантажений файл називається
.gitignore; збережіть його в корені репозиторію.
Вибір зберігається в адресі сторінки, тож закладка чи посилання відтворюють той самий файл.
Приклад
Якщо вибрати Node.js, macOS і VS Code, додати власне правило .env.local і вимкнути коментарі, вийде такий файл (зі скороченнями):
### Node.js ###
logs
*.log
npm-debug.log*
…
node_modules/
…
### macOS ###
.DS_Store
.AppleDouble
.LSOverride
…
### VS Code ###
.vscode/*
!.vscode/settings.json
!.vscode/tasks.json
!.vscode/launch.json
!.vscode/extensions.json
!.vscode/*.code-snippets
!*.code-workspace
*.vsix
### Custom ###
.env.local
Шаблони, що починаються з !, знову включають те, що виключило попереднє правило: тут спільні налаштування, завдання й конфігурації запуску VS Code залишаються в репозиторії, а особистий стан редактора ігнорується. Додавання .env у власні правила нічого б не змінило — шаблон Node.js його вже містить.
Поради
- Правила для особистих інструментів (swap-файли редактора, метадані ОС) зручно тримати в глобальному файлі винятків: вони діють у всіх репозиторіях без повторення.
- Скісна риска в кінці, як у
build/, збігається лише з каталогами; на початку, як у/build, — прив’язує правило до кореня репозиторію. - Команда
git check-ignore -v <шлях>покаже, який рядок якого файлу винятків збігся зі шляхом. - Не розраховуйте, що .gitignore захистить уже закомічені секрети: змініть їх і перепишіть історію.
Часті запитання
› Звідки взято шаблони?
Це вбудовані копії офіційної колекції github/gitignore, яку GitHub публікує як суспільне надбання за CC0. Під час роботи інструмент нічого не завантажує: шаблони входять до складу сторінки.
› Чому файл досі відстежується після додавання до .gitignore?
.gitignore діє лише на невідстежувані файли. Якщо файл уже було закомічено, приберіть його з індексу командою git rm --cached <файл> (для теки — з -r) і зробіть коміт; файл залишиться на диску й надалі ігноруватиметься.
› Що робить «Прибирати повторювані правила»?
Багато шаблонів містять однакові правила: Java і Kotlin ігнорують *.class, C і C++ — *.o. З увімкненою опцією правило записується лише під час першої появи, а коментар-заголовок, усі правила під яким прибрано, теж зникає. Вимкніть її, щоб отримати кожен шаблон точно в опублікованому вигляді.
› Чи треба комітити файл .gitignore?
Так. Закомічений .gitignore діє для всіх, хто клонує репозиторій. Правила, що стосуються лише вашого комп’ютера, наприклад редактора чи ОС, можна винести в глобальний файл винятків (git config --global core.excludesFile ~/.gitignore_global).