...
Eroare Git · Repository, staging și commit

fatal: empty string is not a valid pathspec. please use . instead if you meant to match all paths

Pe scurt

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

Greșit
BASH
FISIER=""
git add "$FISIER"
Corect
BASH
if [ -n "$FISIER" ]; then
  git add "$FISIER"
fi

Ghilimelele transformă variabila goală într-un argument gol. Verificarea -n sare peste comandă când nu ai ce adăuga.

2Ai vrut să adaugi tot

Greșit
BASH
git add ""
Corect
BASH
git add .

. înseamnă folderul curent cu tot ce e în el; șirul gol nu înseamnă nimic pentru Git.

3Rezultatul unei comenzi e gol

Greșit
BASH
git add "$(git ls-files -m | grep '\.css$')"
Corect
BASH
git ls-files -m | grep '\.css$' | xargs -r git add

Când nu e niciun fișier CSS modificat, substituția dă "". xargs -r nu rulează comanda dacă lista e goală.

Repară tu

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.

Alte forme ale mesajului

  • fatal: empty string is not a valid pathspec. please use . instead if you meant to match all paths
  • warning: 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 -r sau 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

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