You are in 'detached HEAD' state — Git не на ветке
Git перешёл на конкретный коммит, а не на ветку. Файлы в папке — из этого коммита, а новые коммиты не попадут ни в одну ветку. Если своих коммитов вы не делали — вернитесь на ветку, если делали — сначала сохраните их в новой ветке.
Содержание 10
Что сделать прямо сейчас
- Посмотрите, где вы:
git status. Первая строкаHEAD detached atи номер коммита значит, что вы не на ветке. - Если после перехода вы не делали коммитов — вернитесь на ветку.
- Если делали и они нужны — сохраните их в ветке.
Команды Git вводятся там, где лежит репозиторий: на сервере — после подключения по SSH (как подключиться), на своём компьютере — в Терминале (Mac) или в Git Bash (Windows).
Что значит сообщение
Note: switching to 'a1b2c3d'.
You are in 'detached HEAD' state. …Перевод: «вы в состоянии detached HEAD» — «HEAD отсоединён». HEAD показывает, где вы сейчас. Когда вы на ветке, HEAD указывает на ветку, и каждый новый коммит двигает её вперёд. После перехода на коммит HEAD указывает прямо на коммит: файлы смотреть можно, а новые коммиты не принадлежат ни одной ветке.
В конце Git пишет строку HEAD is now at с коротким номером коммита. Команда git status в этом состоянии начинает ответ так:
HEAD detached at a1b2c3dЕсли после перехода вы сделали коммит, строка станет HEAD detached from a1b2c3d — «отсоединён от»: вы уже ушли дальше этого коммита.
Откуда это берётся
git checkout a1b2c3dилиgit switch --detach a1b2c3d— переход на старый коммит, например чтобы вернуть сайт к прошлой версии.git checkout v1.0— переход на тег. Если сайт выкладывают по тегам, так и задумано: на сервере коммитов не делают, а на следующую версию переходят той же командой с новым тегом.git checkout origin/main— переход на ветку из репозитория. Для работы нужна своя ветка:git switch main.
Способ 1. Вернитесь на ветку
git switch mainВместо main подставьте свою ветку — список веток покажет git branch. Git напишет строку Previous HEAD position was — где вы были, — а затем Switched to branch 'main': вы снова на ветке. На сервере после этого заберите новый код: git pull.
Вернуться туда, где вы были до перехода на коммит, можно и командой git switch - — её подсказывает сам Git.
Если Git ответил Your local changes to the following files would be overwritten, в папке есть несохранённые правки — что с ними делать.
Способ 2. Сохраните свои коммиты в ветке
Пока вы в состоянии detached HEAD, создайте ветку прямо здесь — ваши коммиты окажутся в ней:
git switch -c fix-1fix-1 — имя новой ветки, придумайте своё, без пробелов. Git ответит Switched to a new branch 'fix-1'. Теперь влейте её в основную ветку:
git switch main
git merge fix-1Если в ответе есть CONFLICT — одни и те же строки изменены в обеих ветках, разбор конфликта.
Если вы уже ушли на ветку
Когда вы уходите с коммитов, которых нет ни в одной ветке, Git предупреждает:
Warning: you are leaving 1 commit behind, not connected to
any of your branches:
e4f5a6b Правка шапки
…e4f5a6b — номер вашего коммита. Ниже Git подсказывает команду git branch с этим номером. Создайте ветку на этом коммите и влейте её, как в способе 2:
git branch fix-1 e4f5a6b
git merge fix-1Если предупреждение уже не видно, номер найдёт git reflog — журнал, куда Git записывает каждое перемещение HEAD: коммиты и переходы между ветками, от новых записей к старым. В начале строки — номер коммита, после слова commit: — текст коммита. Найдите строку со своим текстом и возьмите номер из неё.
git pull пишет You are not currently on a branch
You are not currently on a branch.
…Перевод: «вы сейчас не на ветке». git pull не знает, в какую ветку забирать новые коммиты. Вернитесь на ветку — способ 1 — и повторите git pull.
Как проверить
git statusПервая строка должна быть On branch main — вы на ветке, и новые коммиты попадут в неё.
Источники
- Исходный код Git 2.43.0: advice.c — текст You are in 'detached HEAD' state и подсказка git switch -c.
- Исходный код Git 2.43.0: builtin/checkout.c — строки HEAD is now at, Switched to branch, Warning: you are leaving … и invalid reference.
- Исходный код Git 2.43.0: wt-status.c — строки On branch, HEAD detached at и HEAD detached from в ответе git status.
- Исходный код Git 2.43.0: builtin/pull.c — тексты You are not currently on a branch и There is no tracking information for the current branch.
- Справка git switch — ключи -c, --detach и --guess.
- Справка git reflog — журнал, в котором Git запоминает, куда указывал HEAD.
- Справка git merge — как влить ветку в текущую.
- Пакет git в Ubuntu 24.04 — версия 2.43.0, с ней сверены тексты сообщений.
Сверено 20 октября 2026 года.
Что почитать дальше
- Your local changes would be overwrittenесли Git не даёт уйти с коммита из-за правок в файлах.
- Merge conflictесли при слиянии ветки одни строки изменены с двух сторон.
- pathspec did not match any file(s)если Git не нашёл ветку.
- Все ошибки Gitтаблица сообщений со ссылками на разборы.
- git branch и git switchкак перейти на нужную ветку.