Esta es una recopilación de comandos para trabajar en Git mediante la terminal. La página es una actualización, más extensa y mejor presentada, de una versión anterior, disponible aquí.
Nota: aunque en la descripción de las operaciones me suelo referir a ficheros, sobre lo que se trabaja es sobre modificaciones en los ficheros.
Iniciar un repositorio local
Ir al directorio donde se va a inicial el repositorio
cd d:/xampp/htdocs/repo-x
Tip: al abrir la consola en el directorio donde vamos a trabajar no habrá que escribir la ruta.
Iniciar repositorio
git init
Configurar repositorio
git config --global user.name 'Moises Alcocer'
git config --global user.email 'mi_mail@hgo.es'
Crear fichero .gitignore
echo > .gitignore
Fichero con los nombres de los ficheros, las extensiones y los subdirectorios que no deben ser incluidos en el repositorio. Lo abriremos con un editor de texto y añadimos lo necesario.
Tip: Podemos buscar plantillas según el tipo de desarrollo para no partir de 0, p.e. si empezamos un proyecto con Yii2, buscar "gitignore Yii2". En este fichero aparecen, los añadidos por IDEs, editores, etc. que deben ser ignorados.
Crear fichero README.md
echo > readme.md
Fichero de texto plano con información del repositorio. Necesario en GitHub, donde se muestra a los visitantes del repo.
Iniciar un repositorio remoto
Creamos un repositorio remoto Git en un sitio web especializado (BitBucket, GitHub, etc.) siguiendo sus instrucciones.
Crear un repositorio local (si no existe) y hacer un primer commit
git init
git add README.md
git commit -m 'primer commit'
Sincroniza el repo local con el remoto, por ejemplo:
git remote add origin http://github.com/oricis/nombre-repo.git
Enviar el contenido del repo local (PUSH)
git push -u origin master
Clonar un repositorio remoto
Este procedimiento nos permite obtener un repositorio local con el contenido de uno remoto: ficheros, commits, mensajes de logs...
En el directorio donde se alojará el repositorio, comando:
git clone http://github.com/oricis/nombre-repo.git
Nota: un repositorio privado requiere nombre usuario / contraseña.
Al finalizar tenemos una copia de "casi" todo el contenido del repositorio: faltarían contenidos del proyecto no incluidos por el autor, como logs, imágenes, librerías de terceros... y quizás el fichero, ".gitignore" que tendremos que añadir si es el caso, así como las dependencias necesarias si las hay, que deberían estar reflejado en la documentación del repositorio y ficheros de configuración (package.json, composer.json, etc.).
Si el repo es nuestro, es decir, lo subimos desde otra máquina, podemos traernos lo necesario manualmente.
Conectar el repositorio local con un nuevo repositorio remoto
Pueden dejar de enviarse las actualizaciones del repositorio local al remoto desvinculándolos y vincular un repositorio remoto diferente. Por ejemplo, se cambia el vínculo del repo http://xhub.com/user/skeleton.git a http://xhub.com/user/xna.git
Ver el repositorio remoto al que está vinculado el local
git remote show origin
Desvincular repositorio local del remoto
Después de ejecutar el siguiente comando, el anterior debería dejar de darnos información (hemos desvinculado el repositorio local)
git remote remove origin
Vincular el repo local con uno remoto
git remote add origin http://github.com/oricis/nombre-repo.git
Cambiar vinculación entre repo local y remoto
Las dos acciones anteriores, secuencialmente permiten cambiar de repositorio remoto, es decir, primero se desvincula el original y luego se vincula el nuevo. Con un sólo comando:
git remote set-url origin http://github.com/oricis/nombre-repo.git
Enviar el contenido del repo local (PUSH)
git push -u origin master
Descartar cambios en un fichero desde el último commit
git checkout -- fichero.ext
Si aun aparecen los ficheros como modificados: añadirlos al stage y volver a descartar cambios
git add --all
git checkout -f
Mover ficheros del stage al working area
Sacar todos los ficheros del stage al working area
git reset
git reset HEAD
Sacar un fichero del stage al working area
git reset HEAD fichero.xy
Sacar un directorio completo del stage al working area
git reset HEAD -- path_to/directorio/
Deshacer un PULL (o volver al estado anterior a un PULL)
PULL es la acción por la que traemos al repositorio local el contenido de un repositorio remoto. Podemos restaurar el estado del repositorio local al momento anterior a un PULL
git reset --hard
Limpiar el working area
Si tenemos ficheros como modificados, pero un 'git diff' no muestra cambios, para limpiarlos usamos el comando
git checkout -f
Añadir ficheros al último commit
Podemos incluir ficheros olvidados en el último commit realizado. Primero tenemos que añadir el fichero o ficheros al 'stage area'
git add fichero_olvidado.xxx
Seguidamente usamos el comando
git commit --amend
Se abrirá el editor (Vim, por defecto. Se sale con ZZ)
Modificar mensajes de los commits
Cambiar el mensaje del último commit
Modificar mensaje del último commit en el editor
git commit --amend
Corregir mensaje del último commit de forma directa
git commit -m "Mensaje corregido" --amend
Cambiar el mensaje de un commit anterior
Este procedimiento es algo más complicado que el anterior, por lo que le he dedicado una entrada: Git - Reescribiendo la historia.
Descartar commits
Descartar último commit perdiendo las modificaciones (CUIDADO)
git reset --hard HEAD
o bien
git reset --hard HEAD~1 #Indica núm. de commits a desechar
Descartar último commit conservando las modificaciones
Los ficheros van al working area
git reset HEAD~1 #Indica núm. de commits a desechar
Descartar último commit conservando las modificaciones
Los ficheros van al stage area
git reset --soft HEAD~1 #Indica núm. de commits a desechar
Ver histórico de commits: hash, autor, fecha y mensaje
git log
Ver histórico de commits: hash, autor, fecha y mensaje de un fichero
git log -- path/file.ext
Ver histórico de commits: hash, autor, fecha y mensaje para los ficheros de un directorio
git log -- directory_path/*
Ver últimos commits: hash, autor, fecha y mensaje
El núm. indica cuantos commits mostrar desde el último que se llevó a cabo
git log -2
Ver histórico de commits: hash, autor, fecha, mensaje, ficheros incluidos y tipo cambios de cada uno (líneas borradas y/o añadidas)
Ver todos los ficheros incluidos en un repositorio
git log --stat
Ver últimos 2 commits con diff
El núm. indica cuantos commits mostrar desde el último que se llevó a cabo
git log -p -2
Ver histórico de commits: hash, autor, fecha y mensaje
Realizados desde hace un tiempo determinado
git log --since=2.weeks #En las últimas 2 semanas
git log --since=3.days #En los últimos 3 días
Ver histórico de commits: hash, autor, fecha y mensaje + diff, realizados desde hace un tiempo determinado
git log --since=2.weeks -p #En las últimas 2 semanas
git log --since=3.days -p #En los últimos 3 días
Ver histórico de todos los commits que afectan a un fichero
git log -- path/file.ext
git log --pretty=oneline --branches -- path/file.ext # Una fila por commit
Mostrar una única fila por commit
git log --pretty=oneline --branches # En todas las ramas
git log --pretty=oneline # En la rama actual
Ver histórico de commits con mejoras visuales (origen)
git log --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit
Incluidos los ficheros de cada commit
git log --stat --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit
Configurando un alias (solo una vez)
git config --global alias.lg "log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit"
Ahora la llamada será:
git lg
Ver los cambios de los ficheros con sus versiones anteriores
Cuando un fichero se guarda en el repositorio (después de ser añadido a un commit), pasa a estar bajo el control de versiones. Una vez versionado un fichero podremos ver cada cambio que le afecta desde su primer commit.
Ver cambios de los ficheros en el 'working area'
git diff
Ver cambios de los ficheros en el 'stage area'
git diff --staged
Tip: podemos usar filtros, para operar sobre archivos o grupos concretos
Ficheros de tipo .xx, del directorio raíz, en el 'working area'
git diff *.xx
Todos los ficheros .php y .less, en el 'working area'
git diff -- '*.php' '*.less'
Nombres de los ficheros modificados desde un commit concreto
git diff --name-only <commit-hash> HEAD
Nombres de los ficheros modificados desde un commit concreto, de cierto tipo, p.e. .php:
git diff --name-only <commit-hash> HEAD -- '*.php'
Nota: La cantidad de caracteres mínima para identificar un hash es siete.
Ver cambios en los ficheros del proyecto
Ver ficheros del 'stage area' así como modificados, creados, eliminados... en el 'working area'
git status
Cuando hay muchos cambios podemos añadir filtros al comando anterior
git status | grep deleted: # Sólo eliminados
git status | grep modified: # Sólo modificados
Añadiendo ficheros al 'stage' (mover ficheros del working al stage area)
git add . # Todos los ficheros
git add --all # Todos los ficheros, incluso lo que se ha eliminado
Añadiendo ficheros al 'stage'. Aplicando filtros
git add fichero.in # Un fichero concreto
git add fichero.in xxx.txt # Dos ficheros concretos
git add app/*.php # Ficheros .php del directorio app/ (NO de subdirectorios)
git add app/*/*.php # Ficheros .php del directorio app/ y de subdirectorios
git add app/* # Todos los ficheros del directorio app/ y de los subdirectorios
Añadiendo ficheros al 'stage'. Procedimientos específicos
Añadir todos los ficheros salvo los untracked (no en seguimiento), es decir no añade los nuevos ficheros
git add -u
Añadir todos los ficheros excepto un archivo
Se realiza en dos pasos. Primero se añaden todos los ficheros y seguidamente, se devuelve al área de trabajo el fichero en cuestión
git add --all
git reset -- path/fichero.php
Añadir todos los ficheros excepto los de un directorio
Se realiza en dos pasos. Primero se añaden todos los ficheros y seguidamente, se devuelve al área de trabajo los ficheros del directorio en cuestión
git add --all
git reset -- path/*
Realizar commits
El flujo habitual de trabajo será: crear / modificar un fichero, añadirlo al 'stage', crear / modificar otro fichero, añadirlo al 'stage'... guardar los ficheros del 'stage area' en el repositorio (commit).
Commit con el contenido del 'stage area'
git commit -m 'mensaje "info" del commit'
Commit directo desde del 'working area' (saltándose el stage)
Commit de todos los ficheros
git commit -a -m 'mensaje "info" del commit'
git commit --all -m 'mensaje "info" del commit'
Commit de un fichero concreto
git commit */file.ext -m 'mensaje info del commit'
git commit fichero.ess 'mensaje info del commit'
¡Atención: cuidado con las comillas!
Abrir / cerrar el mensaje siempre con comillas simples u usarlas dobles en el interior del mismo
Sincronizar cambios entre repositorios (local-remoto)
Enviar contenido commiteado al repositorio remoto
git push
Forzando la reescritura de su contenido (cuidado)
git push --force
Traer contenido commiteado desde repositorio remoto
git pull
Ver listado de ramas existentes
Listar todas las ramas disponibles
git branch
Listar las ramas disponibles viendo última confirmación de cambios en cada rama
git branch -v
Listar las ramas que fueron fusionadas con la rama activa
Recomendable antes de eliminar una rama para asegurarnos de no perder el trabajo
git branch --merged
Listar las ramas que no fueron fusionadas con la rama activa
git branch --no-merged
Crear ramas
Crear una nueva rama (sólo se crea, no nos movemos de la actual)
git branch nombre-rama
Crear una nueva rama y saltar a ella (mueve el apuntador HEAD)
git checkout -b otra-rama #Usa la opción -b
La instrucción anterior equivaldría a hacer
git branch otra-rama
git checkout otra-rama
Cambiar de rama
Saltar a otra rama (mueve el apuntador HEAD)
git checkout nombre-rama
git checkout -f nombre-rama #Forzar el salto
Borrar ramas
Debemos encontrarnos en otra rama diferente a la que queremos borrar
git branch -d otra-rama
Si contiene cambios sin fusionar nos da un mensaje de error
Elimina la rama, aunque tenga cambios NO fusionados con la rama activa
git branch -D otra-rama
Borrar ramas remotas
git push origin --delete nombre-rama
git remote prune origin // Eliminar referencia
Fundir ramas
Incorporar el trabajo de una rama a la rama master
git checkout master #Vamos a la rama master si estamos en otra
git merge otra-rama # Fusionamos la rama
git branch -d otra-rama # Borramos la rama fusionada
Se puede tener un repositorio de Git dentro de otro repositorio de Git y guardar los commits de manera independiente
https://git-scm.com/book/en/v2/Git-Tools-Submodules
Este sería el mecanismo "correcto" para por ejemplo casos como el siguiente:
Estamos montando un sitio web que versionamos. Dentro, desarrollamos a su vez una librería, que tiene a su vez su control de versiones, por lo que queremos que los cambios de la librería se guarden en su propio repositorio, pero no aparezcan en el del sitio web que la incluye.
El sistema de submódulos me parece una complicación.
Si se añade el directorio de la librería al '.gitignore' del proyecto que la contiene se trabaja con ambos repositorios de forma independiente.
Comandos para VIM
'Vim' es una cosa infernal para los que entramos en contacto con él por primera vez. Cuando hacemos algo que lo abre, sólo nos queda la opción de cerrar la consola de comandos a lo bruto.
Con unos comandos básicos podremos por lo menos cerrar este editor de la forma "correcta".
Salir de 'Vim' guardando cambios (si se editó contenido)
ZZ
ESC + ZZ
Ahora que hemos conseguido salir, lo mejor será alejarnos de las puertas del infierno para siempre. Esta aplicación fue una maravilla en el pleistoceno medio, por suerte podemos cambiar el editor de texto de 'Git' (ver abajo).
Otros comandos de Git
Cambiar editor de texto de la consola Git
Editor instalado en el equipo (Sublime):
git config --global core.editor "\"c:\Program Files\Sublime Text 3\sublime_text.exe\""
Editor incluido en la terminal de Git (Nano):
git config --global core.editor nano
Ver configuración global de Git
git config --list
Más sobre la configuración de Git en: https://git-scm.com/docs/git-config
Desplazarse por el contenido de un diff / log
Usar las teclas de dirección para movernos arriba y abajo.
Salir de un diff / log
Finalizar la revisión y volver al "modo normal" de la terminal pulsando:
Q
Ignorar ficheros del directorio de trabajo
No realizar seguimiento del archivo, pero mantenerlo en el directorio de trabajo
Útil si se olvida añadir archivos al '.gitignore' antes de crear el repositorio y ya se agregaron al repositorio.
Añadir el fichero / directorio al '.gitignore' y ejecutar:
git rm --cached mi_archivo.xxx
Ver URL asociada a un repositorio remoto:
git remote -v
Recuperar control de la línea de comandos
Para recuperar el control de la terminal, y poder introducir otro comando, por ejemplo, después de un git log, podemos usar una combinación de teclas, que detiene la ejecución del comando:
Ctrl + z
O mejor, la combinación, que cancela el comando en curso y nos devuelve el control de la terminal, incluso cuando un comando no responde y perdemos el control de la misma:
Ctrl + c
Operaciones Sobre Ficheros
Eliminar un fichero
git rm fichero.txt
Cambiar el nombre de un fichero
git mv nombre_actual nombre_nuevo
(Actualizado 16-09-2020)