...
Eroare Git · Modificări locale, checkout și stash

You are in 'detached HEAD' state.

Pe scurt

Ai trecut pe un commit, tag sau branch remote, nu pe un branch local, deci HEAD nu mai e legat de niciun branch. Dacă doar te uiți, revino cu git switch main; dacă ai făcut commit-uri pe care vrei să le păstrezi, creează un branch: git switch -c nume-nou.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

În mod normal, HEAD arată spre un branch (de exemplu main), iar branch-ul arată spre ultimul commit. Când faci git checkout HEAD~1, git checkout v1.0 sau git checkout origin/main, HEAD arată direct spre un commit: e „detașat”. Git te anunță cu un mesaj lung (Note: switching to ... și You are in 'detached HEAD' state.), iar git status scrie HEAD detached at 3f2a1b4 sau HEAD detached from 3f2a1b4.

Starea nu e o eroare: e utilă ca să te uiți la o versiune veche sau să testezi ceva. Problema apare când faci commit-uri aici: ele nu aparțin niciunui branch, iar dacă treci pe main, rămân fără nume și le găsești doar în git reflog. Ca să le păstrezi, creează un branch chiar din această stare, cu git switch -c nume.

De ce apare: cauzele frecvente

1Ai făcut checkout pe un commit vechi și ai lucrat acolo

Greșit
BASH
git checkout HEAD~1
git commit -am "Repară rotunjirea"
git switch main
# commit-ul rămâne fără branch
Corect
BASH
git checkout HEAD~1
git commit -am "Repară rotunjirea"
git switch -c reparatie

git switch -c creează un branch pe commit-ul curent, deci commit-urile făcute în detached HEAD sunt salvate pe el.

2Ai făcut checkout pe un branch remote

Greșit
BASH
git checkout origin/feature
Corect
BASH
git switch feature
# creează branch-ul local care urmărește origin/feature

origin/feature e doar o copie de citit. git switch feature creează branch-ul local pe care poți lucra.

3Un rebase s-a oprit cu conflict

Greșit
BASH
git rebase main
# CONFLICT, git status: HEAD detached
Corect
BASH
# rezolvă conflictul
git add fișier
git rebase --continue

În timpul rebase-ului, HEAD e detașat temporar. După --continue (sau --abort), revii pe branch.

Repară tu

Repară eroarea, direct în pagină

Ai făcut git checkout HEAD~1 ca să repari o versiune mai veche a calculului, apoi ai făcut commit-ul Repară rotunjirea. git status arată acum HEAD detached from .... Salvează reparația pe un branch nou, numit reparatie, și rămâi pe el, fără să modifici main.

Indiciu

Un branch nou creat chiar acum pornește din commit-ul pe care e HEAD.

Alte forme ale mesajului

  • HEAD detached at 3f2a1b4
  • HEAD detached from 3f2a1b4
  • Note: switching to 'HEAD~1'.
  • Warning: you are leaving 1 commit behind, not connected to any of your branches:

Cum o eviți pe viitor

  • Ca să te uiți la o versiune veche, folosește git switch --detach v1.0 conștient, apoi revii cu git switch -.
  • Înainte de orice commit, verifică cu git status că ești pe un branch (On branch ...).
  • Pentru lucru pe o versiune veche, creează direct un branch: git switch -c fix/v1 v1.0.
  • Dacă ai plecat deja din detached HEAD cu commit-uri, mesajul de avertizare îți dă id-ul; folosește git branch nume id.

Întrebări frecvente

Am plecat din detached HEAD și commit-ul a dispărut. Îl pot recupera?

Da. Rulează git reflog, găsește commit-ul după mesaj și creează un branch pe el: git branch reparatie 3f2a1b4.

Pierd ceva dacă doar m-am uitat la un commit vechi?

Nu. Dacă nu ai făcut commit-uri, git switch main te întoarce exact unde erai.

Erori înrudite

← Toate erorile Git

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Git de la zero, cu exerciții la fiecare lecție

Curs Git: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.