Что такое файл .gitignore и как его использовать?

Question

Accepted Answer

Файл **.gitignore** указывает Git, какие файлы и директории **игнорировать** — не отслеживать в системе контроля версий. Он используется для исключения сгенерированных файлов, зависимостей, секретов и файлов, специфичных для конкретного окружения, которые не должны быть закоммичены.

## Что делает .gitignore

```text
# .gitignore — patterns of files Git should NOT track
node_modules/          # dependencies (reinstalled from package files, don't commit)
dist/                  # build output (generated, don't commit)
*.log                  # log files
.env                   # ⚠️ SECRETS / environment variables — NEVER commit!
.DS_Store              # OS-specific junk
.vscode/               # editor config (often personal)
build/
coverage/
*.tmp
```

Git игнорирует файлы, соответствующие этим паттернам — они не будут отображаться в `git status`, не будут добавлены в staging и не будут закоммичены.

## Синтаксис паттернов

```text
node_modules/    → ignore a directory (and everything in it)
*.log            → ignore all files with a .log extension
!important.log   → EXCEPTION: do NOT ignore this (negation)
/build           → ignore "build" only in the root (leading slash = root-relative)
doc/*.txt        → .txt files in doc/ but not subdirectories
**/temp          → "temp" anywhere in the tree
```

## Что игнорировать (распространённые категории)

```text
✓ DEPENDENCIES — node_modules/, vendor/ (reinstalled from manifests; huge, don't commit)
✓ BUILD OUTPUT — dist/, build/, *.o (generated from source)
✓ SECRETS — .env, credentials, keys (⚠️ NEVER commit secrets — a serious security issue)
✓ ENVIRONMENT/OS/EDITOR files — .DS_Store, .idea/, .vscode/ (personal/machine-specific)
✓ LOGS, caches, temp files
```

```text
⚠️ Already-tracked files aren't ignored by adding them later — untrack first:
   git rm --cached <file>   (then commit; .gitignore prevents re-adding)
```

## Почему это важно

Понимание `.gitignore` важно для **поддержания репозитория в чистоте и безопасности**, поэтому это необходимое практическое знание Git.

Файл `.gitignore` исключает файлы, которые **не должны быть в контроле версий**, решая несколько практических задач.

Он поддерживает репозиторий в чистоте, исключая **сгенерированные/производные файлы** (результаты сборки, скомпилированные артефакты) и **зависимости** (`node_modules`, которые огромны и переустанавливаются из файлов-манифестов — их коммит раздувает репозиторий) — таким образом репозиторий содержит только значимый исходный код.

Он исключает **специфичные для окружения и личные файлы** (системный мусор вроде `.DS_Store`, конфиги редакторов), которые загромождали бы репозиторий и создавали шум.

Самое критичное — это **безопасность**: исключение **секретов** (файлы `.env`, учётные данные, API-ключи) жизненно важно, потому что **коммит секретов — серьёзная ошибка безопасности** — однажды закоммиченные, секреты остаются в истории репозитория (и потенциально могут быть отправлены в удалённый/публичный репозиторий, где их можно использовать), поэтому `.gitignore` — ключевая защита от случайного коммита чувствительных данных.

Понимание **синтаксиса паттернов** (директории, подстановочные символы, отрицание, корневые пути) позволяет писать эффективные правила игнорирования, а знание важного подводного камня, что **уже отслеживаемые файлы должны быть удалены из отслеживания** (`git rm --cached`), прежде чем `.gitignore` вступит в силу, предотвращает распространённые ошибки.

Поскольку чистые репозитории (без сгенерированных файлов, зависимостей и мусора) и особенно **отсутствие секретов в версионировании** важны для качества репозитория и безопасности, и поскольку `.gitignore` — стандартный механизм для исключения файлов, которые не должны отслеживаться, понимание `.gitignore` — что игнорировать (зависимости, результаты сборки и критичные секреты), синтаксис паттернов и подводный камень с удалением из отслеживания — это необходимое, часто применяемое знание Git для поддержания чистых и безопасных репозиториев, где аспект безопасности, связанный с исключением секретов из системы контроля версий, особенно важен.