...
Eroare Git · Branch-uri, merge și conflicte

fatal: a branch named 'feature/login' already exists

Pe scurt

Î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

Greșit
BASH
git switch -c feature/login
Corect
BASH
git switch feature/login

Fără -c, git switch doar te mută pe branch-ul existent, cu toate commit-urile lui.

2Ai creat deja branch-ul cu git branch

Greșit
BASH
git branch feature/login
git checkout -b feature/login
Corect
BASH
git branch feature/login
git switch feature/login

git 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ă

Greșit
BASH
git switch -c feature/login
Corect
BASH
git switch -c feature/login-google

Fiecare sarcină primește un nume propriu, care descrie exact ce faci.

Repară tu

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.

Alte forme ale mesajului

  • fatal: A branch named 'feature/login' already exists.

Cum o eviți pe viitor

  • Rulează git branch ca să vezi ce branch-uri ai înainte să creezi unul.
  • Folosește git switch nume pentru branch-uri existente și git switch -c nume doar 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

← 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.