Introduzione

Git include una documentazione interna estensiva. Saperla evocare rapidamente ti farà risparmiare ore di tentativi alla cieca. Questa pagina fa il giro del sistema di aiuto, dalle one-liner ai manuali completi.

Tre modi di chiedere

Ogni comando supporta tre forme di aiuto:

git help <command>     # man page completa nel tuo pager
git <command> --help    # stessa cosa
git <command> -h        # breve riassunto d'uso

Esempio:

git help commit
git commit --help
git commit -h

Elencare i comandi

git help -a            # tutti i comandi
git help -g            # guide (gittutorial, gitcore-tutorial, ecc.)
git help everyday      # il cheatsheet quotidiano di Git

git help everyday in particolare è uno dei migliori riferimenti da principiante a intermedio inclusi con Git.

Guide concettuali

Git include guide in prosa come man page separate:

git help gittutorial
git help gitcore-tutorial
git help gitglossary
git help gitworkflows
git help gitrevisions

gitrevisions è il riferimento canonico per la sintassi dei ref (HEAD~3, main@{yesterday}, ecc.).

Configurare il formato dell'aiuto

Per impostazione predefinita git help apre una man page. Puoi passare a HTML o info:

git config --global help.format html
git config --global help.format info
git config --global help.format man   # default

HTML apre la copia locale nel browser, utile su sistemi senza man.

Risorse online

• git-scm.com/docs: manuale ufficiale rispecchiato online.
• libro Pro Git di Chacon e Straub: gratuito, completo, regolarmente aggiornato.
• archivio della mailing list di Git: lore.kernel.org/git per discussioni di design.

Cercare nella documentazione

Se non ricordi il nome di un comando, man -k git (o apropos git) elenca ogni man page di Git con una descrizione di una riga. Per cercare dentro i documenti, fai pipe a grep:

man -k git
git help -a | grep -i merge
git help log | grep -A 2 'pickaxe'

Per apprendimento approfondito, il libro Pro Git è gratuito e autorevole; il Git Reference Manual su git-scm.com/docs rispecchia le man page con riferimenti incrociati. La man page gitfaq è una gemma sottoutilizzata che risponde a molte domande del mondo reale in prosa semplice.

Errori comuni

Cercare sul web risposte di Stack Overflow obsolete che usano comandi deprecati come git checkout per cambiare branch quando esiste git switch. Verifica sempre con git help per la tua versione installata. Un altro errore è assumere che -h e --help si comportino allo stesso modo; non è così. -h stampa un riassunto di una schermata, mentre --help apre la man page completa (o il browser, a seconda di help.format). Infine, non saltare git help glossary; molti termini "strani" di Git (porcelain, plumbing, refspec, dangling object) sono definiti precisamente lì in una singola pagina breve.