git help în Git

Deschide manualul unei comenzi Git, listează comenzile și ghidurile disponibile sau afișează rezumatul rapid al opțiunilor.

Sintaxă comandă
git help [-a | -g | -c] [<comandă> | <ghid>]
git <comandă> -h

Ce face git help

git help commit (sau echivalentul git commit --help) deschide manualul complet al comenzii, de obicei în pager-ul terminalului (q pentru ieșire). Manualul vine cu versiunea ta de Git, deci descrie exact opțiunile pe care le ai instalate.

Pentru o privire rapidă, git <comandă> -h afișează direct în terminal doar sintaxa și lista scurtă de opțiuni. git help -g listează ghidurile conceptuale (de exemplu gitignore, gitrevisions, gitworkflows), iar git help -a toate comenzile disponibile.

Opțiuni și argumente

Opțiune / Parametru Descriere
&lt;comandă&gt; Deschide manualul comenzii (de exemplu git help rebase).
-a, --all Listează toate comenzile disponibile, inclusiv aliasurile tale.
-g, --guides Listează ghidurile conceptuale.
-c, --config Listează toate variabilele de configurare cunoscute.
-w, --web Deschide manualul în format HTML, în browser.
git &lt;comandă&gt; -h Rezumatul scurt al opțiunilor, direct în terminal.

Exemple

Exemplul 1: Rezumatul rapid al unei comenzi

Primele rânduri din git stash -h arată formele principale ale comenzii, fără să deschidă manualul.

git stash -h 2>&1 | head -4

Rezultat

usage: git stash list [<log-options>]
   or: git stash show [-u | --include-untracked | --only-untracked] [<diff-options>] [<stash>]
   or: git stash drop [-q | --quiet] [<stash>]
   or: git stash pop [--index] [-q | --quiet] [<stash>]

Exemplul 2: Ghidurile conceptuale

git help -g listează ghidurile; oricare se deschide cu git help <nume>. De exemplu, git help revisions explică toate felurile de a numi un commit (HEAD~2, main@{yesterday} etc.).

git help -g | head -5

Rezultat

The Git concept guides are:
   core-tutorial    A Git core tutorial for developers
   credentials      Providing usernames and passwords to Git
   cvs-migration    Git for CVS users
   diffcore         Tweaking diff output

Exemplul 3: Manualul deschis în browser

Util când citești mult sau vrei să cauți în pagină. Formatul ales implicit se poate schimba cu git config --global help.format web.

git help -w rebase

Greșeli frecvente

  • Rularea git help într-un script sau un CI: deschide un pager și așteaptă apăsarea tastei q. În scripturi folosește git <comandă> -h.
  • Căutarea pe internet a opțiunilor unei versiuni mai noi decât cea instalată: manualul local (git help) descrie exact versiunea ta (git --version).

Comenzi înrudite

  • git config: Configurează setările Git la nivel global (utilizator), de sistem sau local pentru depozitul curent.
  • git status: Afișează starea fișierelor: modificate, pregătite pentru commit (staged) sau neurmărite (untracked).