Introducción

La mayoría de la gente aprende Git de la manera difícil, a través de pequeños desastres. Esta página recopila los errores más frecuentes de principiantes y cómo evitarlos (o recuperarse de ellos). Léela una vez ahora y otra vez después de un mes de uso; la segunda pasada tendrá más sentido.

Commitear con la identidad equivocada

Olvidar establecer user.email por repositorio filtra direcciones personales en commits de trabajo. Siempre establece una identidad por repo en clones de trabajo:

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:

Introducción

Un archivo .gitignore lista patrones que Git debe tratar como no rastreados y nunca ofrecer para añadir. Mantiene fuera de tu repositorio los artefactos de build, secretos, metadatos del SO y archivos temporales del editor.

Introducción

git log recorre el grafo de commits desde un punto de partida (predeterminado: HEAD) hacia atrás a través de los padres, mostrando cada commit. Es la herramienta principal para explorar el historial del proyecto.

Uso básico

git log
git log --oneline
git log --oneline --graph --decorate --all

La última forma es la vista navaja suiza: un grafo compacto de cada branch con refs decoradas.

Introducción

El index, también llamado área de staging o caché, es una de las características distintivas de Git. Es un archivo binario en .git/index que contiene el árbol que pretendes commitear a continuación. Entender el index elimina la mayor parte del misterio de la salida de git status.

Introducción

Casi cada sesión de Git sigue el mismo ritmo de tres pasos: edita archivos en tu árbol de trabajo, stagea los cambios que quieres registrar y commitealos al historial. Dominar este bucle es la base de todo lo demás.

Introducción

git init convierte un directorio común en un repositorio Git. Crea un directorio oculto .git que contiene toda la contabilidad de Git: objetos, refs, configuración y hooks. El árbol de trabajo (tus archivos normales) no cambia.

Inicializando un proyecto

mkdir my-project
cd my-project
git init
# Initialized empty Git repository in /home/ada/my-project/.git/

Desde Git 2.28 puedes establecer el nombre del branch inicial en la línea de comandos:

Introducción

Antes de tu primer commit, Git necesita saber quién eres. git config almacena pares clave-valor en tres ámbitos: system (todos los usuarios), global (tu cuenta de usuario) y local (un único repositorio). El ámbito global vive en ~/.gitconfig en Unix y %USERPROFILE%\.gitconfig en Windows.

Identidad

Configura tu nombre y correo; estos quedan grabados en cada commit que haces:

Introducción

Instalar Git es sencillo en todas las plataformas principales. Esta página recorre el método de instalación recomendado para Linux, macOS y Windows, y muestra cómo verificar la instalación.

Linux

La mayoría de las distribuciones de Linux incluyen Git en sus repositorios de paquetes predeterminados. Usa tu gestor de paquetes:

Introducción

Git es un sistema de control de versiones distribuido creado originalmente por Linus Torvalds en 2005 para el desarrollo del kernel de Linux. Registra cambios en archivos a lo largo del tiempo, permite que varias personas colaboren y le da a cada desarrollador una copia completa del historial del proyecto. Hoy Git impulsa la mayor parte del desarrollo de software libre y empresarial del mundo.