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

fatal: cannot lock ref 'refs/heads/feature/login': 'refs/heads/feature' exists; cannot create 'refs/heads/feature/login'

Pe scurt

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

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

Ce înseamnă

Git păstrează branch-urile ca fișiere în .git/refs/heads/. Branch-ul feature este fișierul refs/heads/feature. Un branch feature/login ar trebui să fie fișierul login dintr-un folder refs/heads/feature. Același nume nu poate fi și fișier, și folder, deci Git nu poate „bloca” (crea) referința nouă și explică exact de ce: 'refs/heads/feature' exists.

Problema apare și invers (ai feature/login și vrei feature) și la git fetch / git pull, când pe server există feature/login, iar local ai un origin/feature vechi. Reparația: redenumești sau ștergi branch-ul care blochează numele (la fetch, git fetch --prune curăță referințele vechi de pe remote).

De ce apare: cauzele frecvente

1Ai un branch cu numele exact al categoriei

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

După redenumire nu mai există fișierul refs/heads/feature, deci feature/ poate deveni folder pentru ambele branch-uri.

2Nu vrei să atingi branch-ul existent

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

Un nume fără slash nu cere un folder feature, deci nu intră în conflict.

3La fetch, o referință veche de pe remote blochează numele

Greșit
BASH
git fetch
# cannot lock ref 'refs/remotes/origin/feature/login'
Corect
BASH
git fetch --prune

--prune șterge mai întâi referințele origin/... care nu mai există pe server (de exemplu origin/feature), apoi le creează pe cele noi.

Repară tu

Repară eroarea, direct în pagină

În proiect există deja branch-ul feature, iar git switch -c feature/login dă fatal: cannot lock ref 'refs/heads/feature/login': 'refs/heads/feature' exists. Echipa a decis: branch-ul vechi se redenumește în feature/baza, iar tu creezi feature/login și treci pe el.

Indiciu

Numele feature trebuie eliberat ca să poată deveni „folder” pentru alte branch-uri.

Alte forme ale mesajului

  • error: cannot lock ref 'refs/remotes/origin/feature/login': 'refs/remotes/origin/feature' exists; cannot create 'refs/remotes/origin/feature/login'
  • fatal: cannot lock ref 'refs/heads/feature': 'refs/heads/feature/login' exists; cannot create 'refs/heads/feature'
  • error: some local refs could not be updated; try running 'git remote prune origin' to remove any old, conflicting branches

Cum o eviți pe viitor

  • Nu folosi un nume de categorie (feature, fix) ca nume de branch întreg.
  • Stabilește în echipă convenția categorie/descriere și folosește-o mereu.
  • Rulează din când în când git fetch --prune (sau setează git config --global fetch.prune true).
  • Înainte să creezi o categorie nouă de branch-uri, uită-te în git branch -a dacă nu există deja un branch cu acel nume.

Întrebări frecvente

De ce Git nu poate avea și feature, și feature/login?

Pentru că referințele sunt fișiere și foldere pe disc (sau intrări care respectă aceeași regulă). Un nume nu poate fi simultan fișier și folder.

Ce fac dacă branch-ul feature e deja pe GitHub?

Îl redenumești local, urci noul nume cu git push -u origin feature/baza și ștergi vechiul nume de pe server cu git push origin --delete feature. Anunță echipa, pentru că și ei trebuie să ruleze git fetch --prune.

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.