Introducción

Git incluye una documentación interna extensa. Saber cómo invocarla rápidamente te ahorrará horas de adivinanza. Esta página recorre el sistema de ayuda desde frases de una línea hasta manuales completos.

Tres formas de preguntar

Cada comando soporta tres formas de ayuda:

git help <command>     # man page completa en tu paginador
git <command> --help    # lo mismo
git <command> -h        # resumen corto de uso

Ejemplo:

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

Listando comandos

git help -a            # todos los comandos
git help -g            # guías (gittutorial, gitcore-tutorial, etc.)
git help everyday      # la cheatsheet de Git diaria

git help everyday en particular es una de las mejores referencias para principiantes-a-intermedios incluidas con Git.

Guías de conceptos

Git incluye guías en prosa como man pages separadas:

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

gitrevisions es la referencia canónica para la sintaxis de refs (HEAD~3, main@{yesterday}, etc.).

Configurando el formato de ayuda

Por defecto git help abre una man page. Puedes cambiar a HTML o info:

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

HTML abre la copia local en tu navegador, útil en sistemas sin man.

Recursos en línea

• git-scm.com/docs: manual oficial replicado en línea.
• Pro Git book de Chacon y Straub: gratis, completo, actualizado regularmente.
• Archivo de la lista de correo de Git: lore.kernel.org/git para discusiones de diseño.

Buscando documentación

Si no recuerdas el nombre de un comando, man -k git (o apropos git) lista cada man page de Git con una descripción de una línea. Para buscar dentro de los docs, redirige a grep:

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

Para aprendizaje en formato largo, el libro Pro Git es gratuito y autoritativo; el Manual de Referencia de Git en git-scm.com/docs replica las man pages con enlaces cruzados. La man page gitfaq es una joya poco usada que responde muchas preguntas del mundo real en prosa simple.

Errores comunes

Buscar en la web respuestas obsoletas de Stack Overflow usando comandos deprecados como git checkout para cambiar de branch cuando existe git switch. Siempre verifica contra git help para tu versión instalada. Otro error es asumir que -h y --help se comportan igual; no lo hacen. -h imprime un resumen de una pantalla, mientras que --help abre la man page completa (o el navegador, dependiendo de help.format). Por último, no te saltes git help glossary; muchos términos "raros" de Git (porcelain, plumbing, refspec, dangling object) están definidos con precisión ahí en una sola página corta.