git reset --soft

git reset --soft <commit> перемещает HEAD и указатель текущей ветки на <commit>, оставляя индекс и рабочую директорию нетронутыми. Все изменения откатываемых коммитов остаются подготовленными и готовы к повторному коммиту. Этот метод часто используется для объединения нескольких локальных коммитов в один: git reset --soft HEAD~3 && git commit -m "...". Важно отметить, что, как и --mixed, режим переписывает историю: это безопасно делать локально, но опасно на общих ветках, где потребуется force-push.

Как это работает

git reset --soft перемещает указатель HEAD на указанный коммит, но не изменяет индекс и рабочую директорию. Это позволяет сохранить все изменения, которые были сделаны в коммитах, которые были откатаны. Если вы случайно выполнили git reset --soft и хотите отменить это действие, вы можете использовать git reset --hard HEAD@{1}. Команда git reflog показывает историю всех перемещений HEAD с соответствующими временными метками. Всё, что когда-либо было коммитом, можно восстановить в течение примерно 30 дней. Если вы хотите выровнять локальную ветку под удалённую, используйте команду git reset --hard origin/main, что отбросит все локальные коммиты. Команда git fsck --dangling выдаст список всех unreferenced коммитов.

Когда применять

git reset --soft особенно полезен, когда вы хотите сохранить все изменения, сделанные в нескольких коммитах, но не хотите сохранять историю этих коммитов. Это может быть полезно, если вы случайно сделали несколько коммитов и хотите объединить их в один. Важно помнить, что использование git reset --soft на общих ветках может привести к потере истории коммитов для других участников проекта. В таких случаях лучше использовать git revert, который создаст новый коммит, отменяющий изменения предыдущего коммита, и сохранит историю изменений.

Типичные ошибки

Одной из распространённых ошибок при использовании git reset --soft является незнание о том, что команда git gc --prune=now --aggressive удаляет все unreferenced коммиты, включая те, которые были откатаны с помощью git reset --soft. Это может привести к потере данных, если вы случайно запустите git gc слишком рано. Другой распространённой ошибкой является применение git reset --soft на общих ветках, что может привести к потере истории коммитов для других участников проекта. В таких случаях лучше использовать git revert, который создаст новый коммит, отменяющий изменения предыдущего коммита, и сохранит историю изменений.

Связанные понятия

• Расширенный сброс и Reflog
• git reset --mixed
• git reset --hard
• git reflog