Git: detached HEAD после checkout на конкретный коммит

#Что означает проблема

git checkout с конкретным идентификатором коммита переводит Git в состояние detached HEAD: вы смотрите снимок истории без привязки к имени ветки. Это не повреждение репозитория. Опасность появляется, если в этом состоянии вы создали новые коммиты, а затем ушли на другую ветку, не сохранив на них ссылку.

#Как отличить причины

#Пошаговая диагностика и решение

1. Откройте проект в Git Bash, терминале VS Code или macOS/LinuxВ VS Code выберите «Файл» → «Открыть папку» и каталог проекта, затем «Терминал» → «Создать терминал». Убедитесь, что выполняете команды внутри своего репозитория: git rev-parse --show-toplevel выводит его корень. Запишите текущие незакоммиченные изменения и при необходимости сделайте копию папки, прежде чем переключаться. Перед остальными командами выполните git --version: в ответ должна появиться установленная версия Git. Если терминал сообщает, что git не найден, проверьте установку Git и доступность команды в этом терминале; не продолжайте операции наугад.
2. Отличите detached HEAD от обычной веткиВыполните git status -sb и git branch --show-current. Если вторая команда выводит пустую строку, а статус пишет HEAD (no branch)/HEAD detached, вы не на ветке. Команда git log -3 --oneline покажет последние коммиты на текущей точке. Если git branch --show-current выводит имя ветки, дальнейшее создание спасательной ветки не нужно.
3. Если вы только смотрели старую версию, вернитесь на прежнюю веткуСначала убедитесь в отсутствии незакоммиченных правок: git status --short должен быть пустым. Затем выполните git switch - для возвращения в предыдущее положение переключения. Если оно тоже было отсоединённым, используйте git branch --list и git switch main лишь в случае, когда ваша рабочая ветка действительно называется main. Не применяйте git switch --discard-changes: он может уничтожить ваши правки.
4. Если создали новые коммиты, сначала закрепите их веткойНе переходя никуда, выполните git switch -c rescue-detached-work в терминале проекта. -c создаёт новую ветку от текущего коммита и сразу переключает на неё. Если имя уже занято, выберите другое уникальное имя, например с датой, вместо использования -C: -C способен переставить существующую ветку. Проверьте, что git branch --show-current показывает rescue-detached-work.
5. Если уже переключились и коммита не видно, просмотрите reflogВыполните git reflog --date=iso и найдите запись с текстом вашего коммита или перехода commit: .... Запишите полный или достаточно длинный идентификатор из первой колонки. Выполните git show --stat ВАШ_SHA с заменой на реальный хеш и проверьте автора, дату, файлы. Не выбирайте запись только по номеру HEAD@{1}, потому что эти номера меняются после каждой операции.
6. Восстановите ветку из найденного коммитаУбедившись, что git show показывает правильный коммит, создайте ссылку командой git branch rescue-found-work ВАШ_SHA; подставьте хеш, не вводите слово ВАШ_SHA буквально. Затем выполните git switch rescue-found-work только с чистыми незакоммиченными файлами. В Git Bash/PowerShell такие названия веток можно использовать без дополнительных прав. Если имя уже существует, создайте другое вместо команды с принудительным переименованием.
7. Перенесите работу на нужную ветку только после проверкиЕсли найденный коммит должен попасть в main или другую ветку, не переключайтесь туда и не выполняйте cherry-pick вслепую. Сначала создайте резервную ветку как выше, затем сравните истории (git log --oneline --all --decorate -12) и обсудите с командой перенос через запрос на включение изменений. Так вы не перепишете общую историю.

#Команды для проверки и исправления

#Как проверить результат и что делать, если не помогло

После создания ветки git branch --show-current возвращает её имя, git log -1 --oneline показывает сохранённый коммит. Если он не найден в git reflog, проверьте, что вы открыли прежний клон репозитория и не запускали очистку объектов; автоматического восстановления гарантировать нельзя.