Что такое git stash?

Что такое Git Stash?

Git stash — это команда в системе контроля версий Git, которая позволяет временно сохранить незакоммиченные изменения в рабочей директории и индексе (staging area), чтобы вы могли переключиться на другую ветку или выполнить другие операции без необходимости коммитить незавершённую работу. Это особенно полезно, когда вам нужно срочно переключить контекст, например, для исправления бага в другой ветке, но вы не хотите создавать «грязные» коммиты с частичными изменениями.

Как работает Git Stash

Когда вы выполняете git stash, Git:

1. Сохраняет текущие изменения (как в рабочей директории, так и в индексе) в специальное хранилище — стек stash.
2. Возвращает рабочую директорию к состоянию последнего коммита (как после git checkout -- . или git reset --hard), очищая незакоммиченные изменения.
3. Позволяет вам свободно переключаться между ветками или выполнять другие операции.

Пример использования:

# Допустим, вы работаете над новым функционалом в ветке feature
# и внесли изменения, но ещё не готовы к коммиту
git stash
# Теперь рабочая директория чиста, можно переключиться на другую ветку
git checkout main

# После выполнения задач в main, вернитесь к своей работе
git checkout feature
git stash pop  # Восстанавливаем сохранённые изменения

Ключевые команды и опции Git Stash

• git stash или git stash push — сохраняет изменения в стек stash. По умолчанию сохраняет только отслеживаемые файлы (tracked), но не игнорируемые или новые неотслеживаемые файлы (untracked).
• git stash list — показывает список всех сохранённых stash-записей. Каждая запись имеет уникальный идентификатор (например, stash@{0}).
• git stash pop — применяет последнюю stash-запись (из вершины стека) и удаляет её из стека. Если возникают конфликты, Git оставит их для разрешения.
• git stash apply — применяет stash, но не удаляет его из стека, что полезно, если нужно применить одни и те же изменения в нескольких местах.
• git stash drop — удаляет указанную stash-запись (например, git stash drop stash@{1}).
• git stash clear — полностью очищает весь стек stash.

Полезные опции для git stash

• git stash -u или git stash --include-untracked — сохраняет в stash также и новые неотслеживаемые файлы (untracked). Это важно, если вы создали новые файлы, но ещё не добавили их в индекс с помощью git add.
• git stash -a или git stash --all — сохраняет все файлы, включая игнорируемые (ignored), что редко используется, но может быть полезно в специфичных сценариях.
• git stash save "сообщение" — позволяет добавить описательное сообщение к stash, чтобы легче идентифицировать изменения позже. В современных версиях Git вместо save рекомендуется использовать git stash push -m "сообщение".

Примеры сценариев использования

1. Срочное переключение на другую ветку: Вы работаете над новым функционалом, но нужно срочно исправить баг в production-ветке. Вместо коммита «в процессе» используйте stash:

   git stash
   git checkout production
   # Исправляем баг, коммитим, возвращаемся
   git checkout feature
   git stash pop
   

2. Сохранение промежуточных изменений: Если вы экспериментируете с кодом и хотите сохранить текущее состояние, но не коммитить его, stash служит удобной «черновой» площадкой.

3. Применение stash к другой ветке: Вы можете применить сохранённые изменения к любой ветке, что полезно для переноса наработок:

   git stash
   git checkout new-branch
   git stash pop  # Применяем изменения уже в новой ветке
   

Важные особенности и ограничения

• Стек stash локальный — stash-записи хранятся только в вашем локальном репозитории и не передаются на удалённый сервер при push. Это делает stash удобным для временного хранения личных изменений.
• Риск конфликтов — при применении stash (особенно с pop или apply) могут возникнуть конфликты слияния, если целевая ветка изменилась с момента сохранения stash. В этом случае Git потребует разрешить конфликты вручную.
• Очистка stash — если stash-записи больше не нужны, их стоит удалить, чтобы избежать беспорядка. Неиспользуемые stash могут занимать место, хотя на практике это редко становится проблемой.

Альтернативы Git Stash

В некоторых случаях вместо stash можно использовать:

• Временные коммиты — создать коммит с сообщением типа «WIP» (Work In Progress), а позже отредактировать его с помощью git commit --amend или интерактивного rebase.
• Ветвление — если изменения значительны, лучше сразу работать в отдельной ветке и использовать merge или rebase.

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