Как работает squash?

Как работает squash?

Squash в контексте Git — это операция объединения нескольких коммитов в один. Это критически важный инструмент для поддержания чистоты истории Git проекта, особенно при работе в больших командах. Вместо того, чтобы загрязнять главную ветку множеством промежуточных коммитов (типа 'Fix typo', 'Oops, forgot import'), ты объединяешь их в один осмысленный коммит.

Когда нужен squash?

Squash используется в следующих сценариях:

1. Feature branches — когда у тебя было 5-10 коммитов на feature ветке, но для главной ветки это должен быть один коммит 'Add feature X'
2. Исправления ошибок — коммиты типа 'Oops, forgot file', 'Fix test', 'Update styles'
3. Очистка истории — перед pull request в главную ветку
4. Реиндексирование — восстановление логического порядка коммитов

Метод 1: git rebase -i (Interactive Rebase)

Это самый мощный и гибкий способ:

# Объединить последние 3 коммита
git rebase -i HEAD~3

# В редакторе откроется список коммитов:
# pick abc1234 Add button component
# pick def5678 Fix button styles
# pick ghi9012 Add button tests

# Измени 'pick' на 'squash' (или 's') для коммитов, которые хочешь объединить:
# pick abc1234 Add button component
# squash def5678 Fix button styles
# squash ghi9012 Add button tests

# Сохрани и закрой редактор (Ctrl+X, Y, Enter в nano)
# Git покажет новое сообщение коммита, которое ты можешь отредактировать

Процесс:

1. Git открывает список последних N коммитов
2. Ты отмечаешь, какие коммиты squashить (меняешь pick на squash)
3. Git объединяет их, сохраняя все изменения
4. Ты редактируешь финальное сообщение коммита
5. История становится чище

// Пример до и после:
const before = [
  '7c0e8d1 Add button component',
  '3f2a9b5 Fix button styles',
  '8e1c2a3 Add button tests',
  'a4b9e2c Update docs'
];

const after = [
  '9x8y7z6 Add button component\n\nFix button styles\nAdd button tests\nUpdate docs'
];

Метод 2: git merge --squash (самый практичный)

Этот метод идеален при слиянии feature ветки в main:

# Находишься на main ветке
git checkout main
git pull origin main

# Слить feature ветку с squash
git merge --squash feature/my-feature

# Git скопирует все изменения в staging area
# но не создаст коммит. Ты создаешь его вручную:
git commit -m "Add user authentication feature

Includes:
- OAuth integration
- JWT token handling
- User profile page

Closes #123"

# Затем push
git push origin main

Результат:

• Все 10 коммитов из feature ветки объединены в 1
• История main остаётся чистой
• Feature ветка полностью удаляется из истории

Метод 3: git reset --soft (альтернативный подход)

Этот метод работает без rebase:

# Откатываешься на N коммитов назад, но сохраняешь все изменения
git reset --soft HEAD~3

# Теперь все изменения из последних 3 коммитов в staging area
# Ты можешь создать один новый коммит:
git commit -m "Combined commit message"

Метод 4: git rebase --squash (для чистки истории)

Объединение всех коммитов с базовой веткой:

# Если работаешь с main
git rebase -i main

# И меняешь 'pick' на 'squash' для всех коммитов

Сравнение методов

Практический workflow

# 1. Работаешь на feature ветке
git checkout -b feature/auth
git add button.tsx
git commit -m "Add button"
git add button.test.tsx
git commit -m "Add tests"
git add styles.css
git commit -m "Fix styles"

# 2. Готово к merge? Переходишь на main
git checkout main
git pull origin main

# 3. Squash всё в один коммит
git merge --squash feature/auth

# 4. Создаёшь финальный коммит
git commit -m "Add authentication feature with tests"

# 5. Push
git push origin main

# 6. Удаляешь feature ветку
git branch -d feature/auth

Ошибки и их исправление

Ошибка: Forget to use --squash, создал merge commit

# Reset последний коммит
git reset --soft HEAD~1

# Создай правильный commit
git commit -m "Proper message"

Ошибка: Потерял коммит при rebase

# Git сохраняет рефлог
git reflog
# Найди нужный коммит и reset
git reset --hard abc1234

Лучшие практики

1. Никогда не squashить коммиты в main — в главной ветке коммиты должны быть логичными
2. Squashить перед PR — делай это на feature ветке, а не при слиянии
3. Сохранять историю для отладки — squash только бесполезные коммиты
4. Писать хорошие сообщения — для финального объединённого коммита
5. Никогда не force push в main — это может испортить историю команды

Squash — мощный инструмент для создания чистой, понятной истории Git, которая облегчает отладку и разработку в команде.