Что такое amend в Git?

Git Amend

Git amend — это команда для изменения последнего коммита. Она позволяет добавить забытые файлы, изменить сообщение коммита или исправить код без создания нового коммита в истории. Это полезный инструмент для поддержания чистоты Git истории.

Основная команда

// В командной строке:
// git commit --amend
// или
// git commit --amend --no-edit  (оставить сообщение как есть)

Случай 1: Добавить забытые файлы

Вы закоммитили код, но забыли добавить важный файл:

// Было сделано:
public class UserService {
    public void saveUser(User user) {
        // код без обработки ошибок
    }
}

// Потом поняли, что забыли добавить Exception.java в коммит

Решение:

git add Exception.java        # добавить забытый файл
git commit --amend --no-edit  # добавить в последний коммит

Теперь оба файла в одном коммите, истории нет отдельного коммита для Exception.

Случай 2: Изменить сообщение коммита

Ошибка в названии коммита:

git commit --amend
# Откроется редактор, где можно изменить сообщение

В vim: нажать i, изменить текст, потом Esc, затем :wq (write and quit).

Случай 3: Исправить ошибку в коде

Вы заметили баг в последнем коммите:

// Было в коммите:
public int divide(int a, int b) {
    return a / b;  // BUG: нет проверки на ноль!
}

Исправление:

# 1. Исправить код
public int divide(int a, int b) {
    if (b == 0) throw new IllegalArgumentException("Division by zero");
    return a / b;
}

# 2. Добавить в индекс
git add Calculator.java

# 3. Добавить в последний коммит
git commit --amend --no-edit

Теперь коммит содержит исправленный код. История остаётся чистой.

Опасность: Изменение публичных коммитов

ВАЖНО: amend работает безопасно только с локальными коммитами, которые еще не pushed на сервер.

# ✅ Безопасно — локальный коммит
git commit -m "Add feature"
git commit --amend --no-edit

# ❌ Опасно — коммит уже на сервере
git push origin main
git commit --amend --no-edit  # НЕ ДЕЛАЙ ЭТО!

Если вы amend коммит, который уже в origin, нужно force push:

git commit --amend
git push --force origin main  # ломает историю для других!

Почему это опасно:

• Другие разработчики имеют старый коммит в своей истории
• При pull произойдут конфликты слияния
• История становится несогласованной

Сравнение: Amend vs Новый коммит

# ❌ Плохо — загрязняет историю
git commit -m "Add feature"
git commit -m "Fix typo"  # отдельный коммит для мелочи

# ✅ Хорошо — чистая история
git commit -m "Add feature"
git commit --amend --no-edit  # в один коммит

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

Сценарий 1: Pull request с ошибкой в сообщении

git commit -m "Add feture"  # опечатка
git commit --amend          # исправить перед push
git commit --amend -m "Add feature"  # новое сообщение
git push origin feature-branch

Сценарий 2: Забыли добавить коммент в код

# Код закоммичен:
public List<User> getActiveUsers() {
    return users.stream()
        .filter(u -> u.isActive())
        .toList();
}

# Потом поняли, нужен коммент для сложной логики
public List<User> getActiveUsers() {
    // Фильтруем только активных пользователей для оптимизации памяти
    return users.stream()
        .filter(u -> u.isActive())
        .toList();
}

git add UserRepository.java
git commit --amend --no-edit

Сценарий 3: Изменить автора коммита

git commit --amend --author="John Doe <john@example.com>"

Отмена amend (если случайно произошёл)

# Просмотреть историю всех операций
git reflog

# Вернуться к предыдущему состоянию
git reset --hard HEAD@{1}

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

1. Используй amend только для локальных коммитов до push на origin
2. Проверь статус перед amend — убедись, что это последний коммит
3. Не amend публичные коммиты — создай новый commit для них
4. Используй в комбинации с --no-edit для скорости, когда сообщение правильное
5. Amend лучше, чем отдельный "Fix typo" коммит — история остаётся чистой

Вывод: Amend — это мощный инструмент для поддержания чистоты истории, но требует осторожности при работе с публичными коммитами. Используй его правильно перед push на сервер.