fatal: empty string is not a valid pathspec. please use . instead if you meant to match all paths
Ai dat unei comenzi Git (de obicei git add) un argument gol, "", de multe ori dintr-o variabilă goală într-un script. Pentru toate fișierele folosește git add . , iar în scripturi verifică variabila înainte să o folosești.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un pathspec e argumentul care spune ce fișiere să atingă o comandă: git add app.js, git add src/, git add .. Un șir gol nu e o cale, iar Git refuză explicit, din versiunea 2.16, să-l interpreteze: fatal: empty string is not a valid pathspec. Mesajul îți dă și varianta corectă: dacă voiai toate fișierele, scrie ..
Aproape niciodată nu tastezi "" de mână. Eroarea apare în scripturi și aliasuri, când o variabilă e goală: git add "$FISIER" cu FISIER nesetat, git add "$(git diff --name-only)" când nu e nimic modificat, sau un pas de CI care primește o listă goală.
Caută în script linia cu comanda Git care primește o variabilă și afișează valoarea ei înainte de comandă.
De ce apare: cauzele frecvente
1Variabilă goală într-un script
FISIER=""
git add "$FISIER"if [ -n "$FISIER" ]; then
git add "$FISIER"
fiGhilimelele transformă variabila goală într-un argument gol. Verificarea -n sare peste comandă când nu ai ce adăuga.
2Ai vrut să adaugi tot
git add ""git add .. înseamnă folderul curent cu tot ce e în el; șirul gol nu înseamnă nimic pentru Git.
3Rezultatul unei comenzi e gol
git add "$(git ls-files -m | grep '\.css$')"git ls-files -m | grep '\.css$' | xargs -r git addCând nu e niciun fișier CSS modificat, substituția dă "". xargs -r nu rulează comanda dacă lista e goală.
Repară eroarea, direct în pagină
Scriptul de publicare rulează git add "$FISIERE", dar variabila e goală, iar Git dă fatal: empty string is not a valid pathspec. Adaugă manual toate fișierele proiectului (index.html, stil.css, app.js) și fă un commit cu mesajul Fișierele proiectului.
Indiciu
Mesajul de eroare îți spune ce să folosești în loc de șirul gol.
Reparația
Vezi eroarea:
git add ""Adaugă tot și salvează:
git add .
git status -s
git commit -m "Fișierele proiectului"Rezultat: cele trei fișiere sunt în commit.
De ce merge
Șirul gol nu e o cale validă, așa că Git a oprit comanda în loc să ghicească. git add . adaugă tot ce e în folderul curent, adică exact ce încerca scriptul. În script, reparația pe termen lung e să verifici variabila sau să folosești direct . când vrei toate fișierele.
Alte forme ale mesajului
fatal: empty string is not a valid pathspec. please use . instead if you meant to match all pathswarning: empty strings as pathspecs will be made invalid in upcoming releases. please use . instead if you meant to match all paths
Cum o eviți pe viitor
- În scripturi, verifică variabilele cu
[ -n "$VAR" ]înainte să le dai lui Git. - Pornește scripturile Bash cu
set -u, ca o variabilă nesetată să oprească scriptul cu un mesaj clar. - Pentru liste de fișiere, folosește
xargs -rsau o buclă, nu o singură substituție între ghilimele.
Întrebări frecvente
De ce mergea scriptul înainte?
În versiunile Git mai vechi de 2.16, șirul gol era tratat ca . și adăuga totul, cu un avertisment. Acum e eroare, pentru că adăuga mai mult decât se aștepta autorul scriptului.
Apare și la alte comenzi?
Da, la orice comandă care primește căi: git rm "", git checkout -- "", git diff -- "". Cauza și reparația sunt aceleași.
Erori înrudite
fatal: pathspec 'stil.css' did not match any files git add nu găsește niciun fișier cu numele sau calea pe care ai scris-o. Verifică numele exact cu ls sau git status (inclusiv folderul și literele mari) și rulează git add cu calea corectă, de exemplu git add css/stil.css. Nothing specified, nothing added. Ai rulat git add fără să spui ce fișiere să adauge, așa că Git nu a făcut nimic. Scrie numele fișierelor (git add index.html) sau un punct pentru tot folderul curent (git add .). nothing added to commit but untracked files present (use "git add" to track) Ai fișiere noi în proiect, dar niciunul nu e în staging, deci commit-ul nu are ce salva. Adaugă-le cu git add nume-fișier (sau git add . pentru toate), apoi rulează din nou git commit. Î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.
