fatal: a branch named 'feature/login' already exists
Încerci să creezi un branch cu un nume care există deja. Dacă vrei să lucrezi pe el, treci pe el cu git switch feature/login (fără -c); dacă vrei unul nou, alege alt nume.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
git switch -c nume, git checkout -b nume și git branch nume creează un branch nou. Numele de branch-uri sunt unice într-un repository, așa că, dacă unul cu același nume există deja, Git refuză și nu schimbă nimic: nu te mută pe el și nu îl suprascrie.
De obicei, situația apare când revii la o funcționalitate începută mai demult și repeți comanda de creare din obișnuință, sau când ai adus branch-ul de pe remote și Git l-a creat local automat. Uită-te la lista cu git branch (sau git branch -a pentru cele de pe server). Dacă branch-ul existent e cel pe care vrei să lucrezi, folosește git switch nume. Dacă vrei să-l refaci de la zero dintr-un alt punct, există git switch -C nume, dar acela mută branch-ul și poate pierde commit-uri.
De ce apare: cauzele frecvente
1Vrei să revii pe un branch creat mai demult
git switch -c feature/logingit switch feature/loginFără -c, git switch doar te mută pe branch-ul existent, cu toate commit-urile lui.
2Ai creat deja branch-ul cu git branch
git branch feature/login
git checkout -b feature/logingit branch feature/login
git switch feature/logingit branch nume creează branch-ul fără să te mute pe el. Pasul următor e doar mutarea.
3Vrei un branch nou pentru altă sarcină
git switch -c feature/logingit switch -c feature/login-googleFiecare sarcină primește un nume propriu, care descrie exact ce faci.
Repară eroarea, direct în pagină
Ai început ieri formularul de login pe branch-ul feature/login. Azi ai scris din obișnuință git switch -c feature/login și ai primit fatal: a branch named 'feature/login' already exists. Continuă lucrul pe branch-ul existent: adaugă linia validare parola la sfârșitul lui login.js și fă un commit, fără să atingi main.
Indiciu
Branch-ul există, deci doar te muți pe el.
Reparația
Vezi eroarea și lista branch-urilor:
git switch -c feature/login
git branchTreci pe branch-ul existent și continuă lucrul:
git switch feature/login
echo "validare parola" >> login.js
git commit -am "Validează parola"Rezultat: feature/login are acum trei commit-uri (cel de pe main, formularul și validarea), iar main a rămas neschimbat.
De ce merge
-c înseamnă „creează”, iar Git nu poate crea un al doilea branch cu același nume. Comanda care te duce pe un branch existent e git switch nume, fără opțiuni: working directory-ul se actualizează cu fișierele branch-ului, inclusiv login.js din commit-ul de ieri, iar commit-urile noi se adaugă peste ele.
Alte forme ale mesajului
fatal: A branch named 'feature/login' already exists.
Cum o eviți pe viitor
- Rulează
git branchca să vezi ce branch-uri ai înainte să creezi unul. - Folosește
git switch numepentru branch-uri existente șigit switch -c numedoar pentru cele noi. - Șterge branch-urile terminate și unite (
git branch -d nume), ca lista să rămână scurtă. - Folosește nume descriptive, cu prefix:
feature/,fix/,hotfix/.
Întrebări frecvente
Ce face git switch -C?
Creează branch-ul sau, dacă există, îl mută forțat pe commit-ul curent. Commit-urile vechi ale branch-ului rămân fără nume (le găsești doar în reflog), deci folosește-l doar dacă știi că nu ai nevoie de ele.
De ce apare mesajul cu majusculă (A branch named) la alții?
Versiunile mai vechi de Git scriau fatal: A branch named 'x' already exists. Înseamnă același lucru.
Erori înrudite
fatal: invalid reference: feature/plata git switch nu găsește niciun branch cu acest nume, nici local, nici printre cele aduse de pe remote. Verifică numele cu git branch -a; dacă branch-ul e al unui coleg, rulează întâi git fetch, apoi git switch feature/plata. error: the branch 'experiment' is not fully merged. Branch-ul pe care vrei să-l ștergi are commit-uri care nu sunt în branch-ul curent, deci le-ai pierde. Dacă munca trebuie păstrată, unește-l întâi (git merge experiment), apoi git branch -d; dacă nu mai ai nevoie de ea, șterge-l forțat cu git branch -D. merge: feature-plata - not something we can merge git merge nu găsește niciun branch, tag sau commit cu numele dat. Verifică numele exact cu git branch (de multe ori e o greșeală de tastare sau un branch care e doar pe remote) și rulează git merge cu numele corect. Î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.
