🧱 2. Git Basics

Creează în directorul curent subdirectorul .git, cu scheletul depozitului; nimic nu este încă urmărit. Creează și ramura implicită master.

Depozitul Git: proiectul pus sub controlul versiunilor, împreună cu tot istoricul lui. Se obține fie transformând un director local într-un depozit (git init), fie clonând un depozit existent (git clone).

Obține o copie completă a unui depozit existent — aproape toate datele serverului, fiecare versiune a fiecărui fișier din istoric: creează directorul, inițializează .git, aduce datele și extrage o copie de lucru a ultimei versiuni; adaugă automat depozitul sursă ca origin.

Principala unealtă care arată starea fișierelor: modificate, puse în staging, neurmărite, plus ramura curentă; git status -s (--short) dă un format compact pe două coloane (staging area / working tree).

Starea unui fișier pe care l-ai schimbat, dar pe care încă nu l-ai înregistrat (commit) în baza de date.

Fișier care era în ultimul snapshot sau a fost nou pus în staging; poate fi unmodified, modified sau staged. Pe scurt, fișierele urmărite sunt cele pe care Git le cunoaște.

Orice alt fișier din working directory: nu era în ultimul snapshot și nu este în staging area. Git nu îl include în commit-uri până nu îi ceri explicit (git add).

Starea în care datele sunt stocate în siguranță în baza de date locală, adică în directorul Git.

Comandă multifuncțională: începe urmărirea fișierelor noi, pune în staging fișierele modificate și marchează conflictele de fuziune ca rezolvate — „adaugă exact acest conținut în următorul commit”. Git pune în staging fișierul exact așa cum este în momentul rulării.

Numele implicit al ramurii create de git init; nu este o ramură specială, ci doar cea creată implicit, pe care puțini o redenumesc (multe gazde folosesc acum main).

Starea unui fișier modificat pe care l-ai marcat, în versiunea lui curentă, ca să intre în următorul snapshot (commit).

Fișier care listează tipare de fișiere pe care Git nu trebuie să le adauge și nici să le arate ca neurmărite (jurnale, fișiere generate la build). Liniile goale și cele cu # se ignoră, tiparele glob se aplică recursiv, / la început evită recursivitatea, / la final indică un director, ! neagă un tipar.

Arată exact liniile adăugate și șterse (patch-ul). Fără argumente compară working directory cu staging area (modificările încă nepuse în staging); git diff --staged (sinonim --cached) compară staging area cu ultimul commit.

Textul care descrie un commit, scris în editor sau dat cu -m. Ghidul proiectului Git: un prim rând de cel mult ~50 de caractere care rezumă modificarea, un rând liber, apoi o explicație mai detaliată.

Creează un commit din ce se află în staging area: lansează editorul pentru mesaj sau primește mesajul cu -m; -v include diff-ul în editor, iar -a pune automat în staging fișierele deja urmărite (sare peste staging area).

Scoate un fișier din fișierele urmărite (din staging area) și îl șterge din working directory; -f forțează ștergerea unui fișier modificat sau pus în staging, iar --cached îl păstrează pe disc, dar oprește urmărirea.

Afișează istoricul commit-urilor în ordine cronologică inversă (SHA-1, autor, dată, mesaj). Opțiuni utile: -p/--patch, --stat, --pretty (oneline, format), --graph, --oneline; limitare cu -<n>, --since/--until, --author, --grep, -S și o cale.

git commit --amend refă ultimul commit cu staging area curentă (eventual doar cu alt mesaj): nu îl repară, ci îl înlocuiește complet cu un commit nou. Se face doar pe commit-uri locale, care nu au fost trimise (push) undeva.

Uneltele de bază pentru anularea modificărilor: refacerea ultimului commit (--amend), scoaterea unui fișier din staging și renunțarea la modificările unui fișier; unele anulări nu pot fi anulate, deci se poate pierde muncă.

Manipulează cei trei arbori: mută ramura spre care arată HEAD și, opțional, actualizează indexul și working directory; git reset HEAD <file> scoate un fișier din staging.

Comandă introdusă în Git 2.23.0, alternativă la git reset pentru multe anulări: git restore --staged <file> scoate un fișier din staging, iar git restore <file> renunță la modificările locale.

Versiune a proiectului găzduită pe Internet sau în rețea (sau chiar pe aceeași mașină), read-only sau read/write; colaborarea înseamnă să trimiți (push) și să aduci (pull) date către și din aceste depozite.

Gestionează depozitele la distanță: fără argumente listează numele scurte (shortnames), -v arată URL-urile; git remote add <shortname> <url>, git remote show <remote>, git remote rename, git remote remove.

Numele implicit pe care Git îl dă serverului de la care ai clonat; ca și master, nu are nimic special (cu git clone -o se poate alege alt nume).

Aduce din depozitul la distanță toate datele pe care nu le ai încă și actualizează ramurile de urmărire la distanță (de exemplu origin/master); nu face merge și nu modifică ce lucrezi.

Aduce datele (fetch) și apoi încearcă să integreze (merge) în ramura curentă ramura la distanță urmărită — în esență git fetch urmat de git merge; cu pull.rebase sau --rebase face rebase în loc de merge.

Trimite commit-urile unei ramuri spre un depozit la distanță: git push <remote> <branch>. Funcționează doar cu drept de scriere și dacă nimeni nu a trimis între timp; altfel trebuie întâi să aduci și să integrezi munca celorlalți.

Listează etichetele (alfabetic; -l pentru un tipar), creează etichete (-a anotată, -m mesaj; fără opțiuni una lightweight) și le șterge local (-d).

Etichetă care marchează un punct important din istoric, de obicei o versiune lansată (v1.0, v2.0). Git are etichete lightweight și annotated; git push nu le trimite implicit (git push origin <tagname> sau --tags).

Situația în care niciun fișier urmărit nu este modificat și nu există fișiere neurmărite; e bine să ai o stare curată când schimbi ramura.

Starea unui fișier urmărit care nu s-a schimbat de la ultimul commit — de exemplu toate fișierele imediat după clonare.

Expresii regulate simplificate folosite de shell: se potrivește cu oricâte caractere, ? cu un singur caracter, [abc] cu un caracter din paranteze, [0-9] cu un interval, iar cu directoare imbricate.

Scurtătura git commit -a: Git pune automat în staging toate fișierele deja urmărite înainte de commit, fără git add; comod, dar poate include modificări nedorite.

Redenumește un fișier. Git nu stochează metadate despre mutări, ci deduce redenumirea; git mv este echivalent cu mv, git rm și git add — o comandă de comoditate.

Persoana care a scris inițial o lucrare; când un membru al proiectului aplică un patch trimis de tine, tu rămâi autor, iar el devine committer.

Persoana care a aplicat ultima dată lucrarea (de exemplu membrul care a aplicat patch-ul trimis de autor).

git push --force suprascrie istoria de pe server (de exemplu după un rebase sau amend); colaboratorii care și-au bazat munca pe commit-urile vechi ajung cu istorii dublate și confuze.

Scoaterea unui fișier din staging area fără a-i pierde modificările din working directory: git reset HEAD <file> sau, din Git 2.23, git restore --staged <file>.

Renunțarea la modificările locale ale unui fișier, readus la ultima versiune din staging sau din commit: git checkout -- <file> sau git restore <file>. Comandă periculoasă: modificările necomise se pierd definitiv.

Etichetă stocată ca obiect complet în baza de date Git: are checksum, numele, e-mailul și data celui care a etichetat, un mesaj și poate fi semnată și verificată cu GPG; este varianta recomandată.

Etichetă care seamănă cu o ramură ce nu se schimbă: doar un pointer la un commit — checksum-ul commit-ului salvat într-un fișier, fără alte informații.

Starea în care HEAD indică direct un commit, nu o ramură (de exemplu după git checkout pe o etichetă); un commit nou făcut acum nu aparține niciunei ramuri și rămâne accesibil doar prin hash-ul exact.

Scurtătură definită cu git config (de exemplu alias.ci commit), astfel încât git ci înlocuiește git commit; un alias care începe cu ! rulează o comandă externă.

Afișează diferențele într-un program extern de vizualizare (emerge, vimdiff etc.); git difftool --tool-help arată ce instrumente sunt disponibile.

Opțiunea -S a lui git log („pickaxe”): primește un șir și arată doar commit-urile care au schimbat numărul aparițiilor acelui șir.