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).
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
git branch feature
git switch -c feature/logingit branch -m feature feature/baza
git switch -c feature/loginDupă 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
git switch -c feature/logingit switch -c feature-loginUn nume fără slash nu cere un folder feature, deci nu intră în conflict.
3La fetch, o referință veche de pe remote blochează numele
git fetch
# cannot lock ref 'refs/remotes/origin/feature/login'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ă 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.
Reparația
Vezi eroarea și branch-urile existente:
git switch -c feature/login
git branchRedenumește branch-ul vechi, apoi creează-l pe cel nou:
git branch -m feature feature/baza
git switch -c feature/login
git branchRezultat: git branch arată feature/baza, * feature/login și main.
De ce merge
Branch-ul feature ocupa numele refs/heads/feature, așa că nu putea exista și un folder feature/ pentru feature/login. git branch -m feature feature/baza mută branch-ul vechi sub categoria feature/, păstrându-i commit-urile. Apoi feature/login se creează fără conflict, iar ambele branch-uri stau acum în aceeași categorie.
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 -adacă 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
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: '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. 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. Î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.
