Что такое Staging Area в Git?

Staging Area в Git

Staging Area (индекс) — это промежуточная зона между рабочей директорией и репозиторием Git, которая позволяет выбирать какие изменения включить в следующий коммит. Это один из самых мощных и часто неправильно понимаемых механизмов Git.

Три состояния в Git

Git работает с тремя основными состояниями файлов:

Working Directory     Staging Area     Repository (.git)
   (Changes)         (Index)        (Commits History)
      |                  |                |
   git add --------->  git commit ----->  .git
      |                  |
   git restore  <---  git restore --staged

1. Working Directory — текущие файлы в вашем проекте (могут быть изменены)
2. Staging Area — набор файлов которые будут включены в следующий коммит
3. Repository — история коммитов в .git директории

Основные команды Staging Area

git add

Добавляет изменения в Staging Area:

// Добавить конкретный файл
git add src/main/java/Example.java

// Добавить все изменённые файлы
git add .

// Добавить файлы по паттерну
git add src/*.java

// Интерактивное добавление (выбираешь хунки)
git add -p

// Добавить изменения (новые файлы не добавляются)
git add -u

git status

Показывает состояние файлов:

On branch main

Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        modified:   src/main/java/User.java
        new file:   src/test/java/UserTest.java

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
        modified:   pom.xml
        deleted:    src/old/Legacy.java

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        .idea/
        target/

git restore --staged

Удаляет файлы из Staging Area:

// Удалить конкретный файл из staging
git restore --staged src/main/java/Example.java

// Удалить все файлы из staging
git restore --staged .

Практический пример использования

// 1. Изменяем несколько файлов
// src/main/java/UserService.java — новая функция
// src/main/java/UserRepository.java — багфикс
// src/test/java/UserServiceTest.java — тесты

// 2. Проверяем что изменилось
git status

// 3. Добавляем только bugfix в staging
git add src/main/java/UserRepository.java

// 4. Коммитим bugfix отдельно
git commit -m "Fix: prevent null pointer in UserRepository"

// 5. Затем добавляем новую функцию с тестами
git add src/main/java/UserService.java src/test/java/UserServiceTest.java

// 6. Коммитим новую функцию
git commit -m "Feature: add user activation mechanism"

Partial Staging — добавление отдельных хунков

// Интерактивное добавление позволяет выбрать какие части файла добавить
git add -p

// В интерактивном режиме:
// y — добавить хунк в staging
// n — пропустить хунк
// s — разделить хунк на меньшие части
// e — редактировать хунк
// q — выйти из режима

// Пример: файл изменён в двух местах, но в staging нужна только одна часть

Просмотр Staging Area

// Показать какие файлы в staging
git status

// Показать diff между рабочей директорией и staging
git diff

// Показать diff между staging и последним коммитом
git diff --staged

// Показать список всех файлов в staging
git diff --staged --name-only

Отмена изменений

// Восстановить файл из рабочей директории (отменить несохранённые изменения)
git restore src/main/java/Example.java

// Восстановить файл из staging area
git restore --source=HEAD src/main/java/Example.java

// Удалить файл из staging но оставить в рабочей директории
git restore --staged src/main/java/Example.java

// Полностью отменить все изменения (опасно!)
git restore .

Staging Area и конфликты слияния

При разрешении конфликтов используется Staging Area:

// 1. Начинаем merge
git merge feature-branch

// 2. Если есть конфликты, редактируем файлы
// <<<<<<<< HEAD
// version 1
// ========
// version 2
// >>>>>>>> feature-branch

// 3. После редактирования добавляем в staging
git add src/main/java/ConflictFile.java

// 4. Завершаем merge
git commit -m "Merge: feature-branch"

Advanced Staging техники

Reset с сохранением изменений

// Отменить последний коммит но сохранить изменения в staging
git reset --soft HEAD~1

// Отменить последний коммит и вывести изменения в рабочую директорию
git reset --mixed HEAD~1

// Полностью отменить последний коммит
git reset --hard HEAD~1

Stash для сохранения промежуточных изменений

// Сохранить текущие изменения (staging + working)
git stash

// Применить последнее сохранённое состояние
git stash pop

// Сохранить только рабочую директорию (не staging)
git stash push -u

// Просмотреть все stashed изменения
git stash list

Практические сценарии

Сценарий 1: Случайные изменения

// Случайно отредактировал несколько файлов
git add file1.java file2.java file3.java

// Понял что file3 не нужна
git restore --staged file3.java
git restore file3.java

// Коммитим только file1 и file2
git commit -m "Fix: improvements to core logic"

Сценарий 2: Разделение большого коммита

// Отменяем последний коммит но сохраняем изменения
git reset --soft HEAD~1

// Теперь все файлы в staging, можем выборочно добавлять
git restore --staged .

// Добавляем и коммитим отдельно
git add feature-part1.java
git commit -m "Feature: part 1"

git add feature-part2.java
git commit -m "Feature: part 2"

Сценарий 3: Cherry-picking изменений

// Отредактировали файл в двух местах
// Хотим коммитить части отдельно
git add -p file.java

// Выбираем нужные хунки
// После завершения первый коммит готов
git commit -m "Fix: bug A"

// Добавляем оставшиеся хунки
git add file.java
git commit -m "Feature: new feature B"

Best Practices со Staging Area

• Используй Staging Area — не всегда коммитить всё сразу
• Маленькие коммиты — каждый коммит должен быть логически законченным
• Просмотри перед коммитом — используй git diff --staged перед git commit
• Используй git add -p — для выборочного добавления изменений
• Не полагайся на .gitignore только — явно управляй что коммитится
• Регулярно коммитить — не копи изменения в staging надолго

Инструменты для работы с Staging

• IntelliJ IDEA — встроенный Git UI с Staging Area
• VS Code — расширение для Git с visual staging
• GitHub Desktop — простой интерфейс для staging
• SourceTree — визуальный клиент Git
• Git Extensions — Windows-ориентированный инструмент

Staging Area — это ключевой механизм Git который позволяет контролировать что именно попадает в каждый коммит, делая историю проекта чистой и понятной.