Поиск
Ошибки

You are in 'detached HEAD' state — Git не на ветке

Git перешёл на конкретный коммит, а не на ветку. Файлы в папке — из этого коммита, а новые коммиты не попадут ни в одну ветку. Если своих коммитов вы не делали — вернитесь на ветку, если делали — сначала сохраните их в новой ветке.

≈ 6 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Посмотрите, где вы: git status. Первая строка HEAD detached at и номер коммита значит, что вы не на ветке.
  2. Если после перехода вы не делали коммитов — вернитесь на ветку.
  3. Если делали и они нужны — сохраните их в ветке.

Команды 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-1

fix-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 — вы на ветке, и новые коммиты попадут в неё.

Источники

Сверено 20 октября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше