Pregătirea fișierelor: git add și staging area
Git nu salvează automat tot ce e în folder. Tu alegi ce intră în următoarea versiune, punând fișierele într-o zonă de pregătire numită staging area. În această lecție înveți comanda git add și vezi în diagramă cum trec fișierele din Working directory în Staging area.
Staging area: coșul pentru următorul commit
Imaginează-ți că faci cumpărături online. Pui produsele în coș, te mai răzgândești, scoți unul, mai adaugi altul, iar abia la final apeși „Plasează comanda”. Staging area (zona de pregătire) este coșul lui Git: pui în ea fișierele pe care vrei să le salvezi, iar commit-ul (lecția următoare) este „Plasează comanda”.
De ce nu salvează Git pur și simplu tot? Pentru că de multe ori ai în folder lucruri care nu trebuie să intre în versiune: notițe personale, o pagină începută, un fișier de test. Cu staging area alegi exact ce intră.
Repository-ul site-ului are trei fișiere noi:
git status
On branch main No commits yet Untracked files: (use "git add <file>..." to include in what will be committed) index.html notite.txt stil.css nothing added to commit but untracked files present (use "git add" to track)
Repository-ul site-ului are trei fișiere noi: index.html, stil.css și notite.txt. Pune în staging doar paginile site-ului (index.html și stil.css), nu și notițele tale.
- Rulează git status ca să vezi cele trei fișiere neurmărite.
- Adaugă index.html și stil.css cu git add.
- Verifică cu git status: notite.txt trebuie să rămână la „Untracked files”.
- Uită-te în diagramă la cutia Staging area.
Soluția exercițiului
git status git add index.html stil.css git status
Vrei să afli mai mult?git add: pune un fișier în staging · Mai multe fișiere deodată · M-am răzgândit: scot un fișier din staging · Greșeli frecvente · Rezumat și exemple reale
git add: pune un fișier în staging
Comanda git add urmată de numele fișierului îl pune în staging area:
git add index.html
Ca multe comenzi Git, git add nu afișează nimic când reușește. Vezi efectul cu git status:
git status
On branch main No commits yet Changes to be committed: (use "git rm --cached <file>..." to unstage) new file: index.html Untracked files: (use "git add <file>..." to include in what will be committed) notite.txt stil.css
Acum ieșirea are două secțiuni:
- Changes to be committed: („schimbări care vor intra în commit”): aici e new file: index.html, scris cu verde în terminal. Fișierul este în staging.
- Untracked files:: notite.txt și stil.css sunt în continuare neurmărite.
Ce s-a schimbat în diagramă
În dreapta, index.html apare acum și în cutia Staging area, cu eticheta „nou”, iar cutia arată „1 schimbare pregătită pentru commit”. Fișierul nu s-a mutat fizic nicăieri: e tot în folderul tău, dar Git și-a notat versiunea lui de acum ca fiind pregătită pentru commit.
Mai multe fișiere deodată
Poți da mai multe nume, separate prin spațiu. Să adăugăm și foaia de stil:
git add stil.css
git status
On branch main No commits yet Changes to be committed: (use "git rm --cached <file>..." to unstage) new file: index.html new file: stil.css Untracked files: (use "git add <file>..." to include in what will be committed) notite.txt
index.html și stil.css sunt în staging, iar notite.txt a rămas pe dinafară, exact cum voiam: notițele personale nu fac parte din site. O comandă echivalentă cu cele două git add ar fi fost git add index.html stil.css.
M-am răzgândit: scot un fișier din staging
Dacă ai adăugat din greșeală un fișier nou, îl scoți din staging cu comanda sugerată chiar de git status: git rm --cached <fișier>.
git add notite.txt
git rm --cached notite.txt
rm 'notite.txt'
Mesajul rm 'notite.txt' sună înfricoșător, dar opțiunea --cached înseamnă „scoate-l doar din staging”: fișierul rămâne în folder, neatins. Vom vorbi mai mult despre scoaterea din staging în lecțiile despre anularea greșelilor.
ls
index.html notite.txt stil.css
Greșeli frecvente
git add contact.html
fatal: pathspec 'contact.html' did not match any files
*pathspec 'contact.html' did not match any files* înseamnă „nu există niciun fișier cu acest nume”. Verifică numele cu ls (o literă greșită, o extensie lipsă) și folderul în care ești.
- Crezi că git add a salvat fișierul: nu, doar l-a pregătit. Fără commit, nu există încă nicio versiune.
- Uiți să verifici: după git add rulează git status, ca să vezi că în staging e exact ce voiai.
- git add fără nume de fișier: Git îți spune *Nothing specified, nothing added*, adică nu i-ai spus ce să adauge.
Rezumat și exemple reale
Ai reparat coșul și ai început o pagină de reduceri: adaugi în staging doar reparația, ca să o salvezi separat.
Pui în staging capitolul terminat, nu și ciorna cu idei.
Un fișier cu parole nu se adaugă niciodată: staging area te obligă să alegi conștient.
