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

fatal: 'feature login' is not a valid branch name

Pe scurt

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

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

Spațiul nu e permis în numele unei referințe. Cratima sau slash-ul păstrează numele lizibil.

2Două puncte la rând

Greșit
BASH
git branch release..2
Corect
BASH
git 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

Greșit
BASH
git switch -c "fix:cos?gol"
Corect
BASH
git switch -c fix/cos-gol

: și ? sunt interzise. Păstrează doar litere, cifre, cratime și slash.

Repară tu

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.

Alte forme ale mesajului

  • fatal: 'release..2' is not a valid branch name
  • fatal: '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

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