fatal: 'feature login' is not a valid branch name
Numele de branch conține caractere pe care Git nu le acceptă (spații, două puncte la rând, ~ ^ : ? * [ sau \). Folosește cratimă sau slash: git switch -c feature-login sau feature/login.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Git salvează branch-urile ca referințe (refs/heads/<nume>), iar numele lor trebuie să respecte câteva reguli: fără spații, fără .., fără caracterele ~ ^ : ? * [ \, fără să se termine cu . sau .lock și fără / la început sau la final. Dacă numele încalcă o regulă, Git refuză să creeze branch-ul și repetă numele primit între ghilimele.
Spațiul este cauza cea mai frecventă: git switch -c "feature login" (cu ghilimele, altfel shell-ul ar împărți numele în două argumente). Convenția din echipe este cratimă între cuvinte și slash pentru categorie: feature/login, fix/cos-gol.
De ce apare: cauzele frecvente
1Spațiu în numele branch-ului
git switch -c "feature login"git switch -c feature-loginSpațiul nu e permis în numele unei referințe. Cratima sau slash-ul păstrează numele lizibil.
2Două puncte la rând
git branch release..2git branch release-2.. are sens special în Git (intervale de commit-uri, de exemplu main..feature), deci nu poate apărea într-un nume.
3Caractere speciale copiate din titlul unui tichet
git switch -c "fix:cos?gol"git switch -c fix/cos-gol: și ? sunt interzise. Păstrează doar litere, cifre, cratime și slash.
Repară eroarea, direct în pagină
Vrei să lucrezi la pagina de autentificare pe un branch nou, dar git switch -c "feature login" dă fatal: 'feature login' is not a valid branch name. Creează branch-ul feature/login și treci pe el.
Indiciu
Înlocuiește spațiul cu un caracter permis într-un nume de branch.
Reparația
Vezi eroarea, apoi folosește un nume valid:
git switch -c "feature login"
git switch -c feature/login
git branchRezultat: git branch arată * feature/login.
De ce merge
Numele de branch-uri sunt referințe Git și nu pot conține spații, deci feature login a fost respins și nu s-a creat nimic. feature/login respectă regulile: slash-ul e permis și e folosit des pentru a grupa branch-urile pe categorii. git switch -c creează branch-ul din commit-ul curent și te mută pe el.
Alte forme ale mesajului
fatal: 'release..2' is not a valid branch namefatal: 'fix:cos?gol' is not a valid branch name
Cum o eviți pe viitor
- Folosește litere mici, cifre, cratime și slash:
feature/login,fix/123-cos-gol. - Nu copia titlul tichetului direct; scrie un rezumat scurt.
- Dacă ai dubii, verifică un nume cu
git check-ref-format --branch nume. - Pune numărul tichetului la început, dacă echipa lucrează cu tichete:
feature/123-login. Așa îl găsești ușor și în lista de branch-uri.
Întrebări frecvente
Pot folosi diacritice în numele branch-ului?
Git le acceptă, dar unele unelte și terminale le afișează greșit. În echipă e mai sigur să folosești doar caractere ASCII.
Am creat un branch cu un nume urât, dar valid. Cum îl schimb?
Cu git branch -m nume-vechi nume-nou (sau doar git branch -m nume-nou dacă ești pe el).
Erori înrudite
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. fatal: cannot lock ref 'refs/heads/feature/login': 'refs/heads/feature' exists; cannot create 'refs/heads/feature/login' Există deja un branch numit feature, iar Git nu poate crea feature/login în același timp. Redenumește branch-ul vechi (git branch -m feature feature/baza) sau alege alt nume pentru cel nou (feature-login). 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. Î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.
