Sección perteneciente al curso Control de versiones con Git Avanzado.

Una de las unidades más importantes. Veremos cómo preparar un commit. Un commit no es un backup sino un momento concreto en la historia de cambios de nuestro proyecto. Una de las características más potentes de Git es que nos permite preparar el commit, qué ficheros van a ir a un commit y cuáles no.

También veremos cómo ver commits del pasado y cómo deshacerlos.

Tanto para añadir nuevos archivos al repositorio (empezar a versionar) como para añadir modificaciones en archivos ya existentes, tendremos que “subirlos al stage”:

git add <RUTA>

Cuando queremos “subir al stage” un archivo:

git add archivo

Si queremos añadir más de un archivo:

git add archivo1 archivo2 archivo3

Si queremos añadir un tipo de ficheros:

git add *.html

Para subir todos los archivos y modificaciones pendientes de pasar al stage y que estén en la carpeta actual (y todas las carpetas hijas):

git add .

Para ver información sobre las 3 zonas que usamos en Git, usamos el siguiente comando:

''git status''

Podemos ver un resumen de los ficheros que están en el stage y los que no están siendo controlados (versionados) por git. Los primeros aparecen en color verde y los segundos en color rojo. Otra forma de decirlo sería que lo que está en verde es lo que está en el stage y lo que está en rojo es lo que está en el working directory.

Si queremos quitar modificaciones del stage (por algún error):

git reset HEAD <RUTA_FICHERO>

Por ejemplo, si queremos quitar el fichero fichero1:

git reset HEAD archivo1

Si queremos quitar todos los cambios que haya en el stage:

git reset HEAD .

Para deshacer cambios en el working directory, es decir, para que Git deje los archivos modificados como estaban en el último commit:

git checkout -- <RUTA_FICHERO>

Por ejemplo, si queremos volver al estado anterior de todos los archivos del working directory:

git checkout -- .

Finalmente, si queremos borrar un archivo tenemos dos opciones. Si el borrado lo hacemos mediante las operaciones del sistema operativo, Git lo entiende como una modificación del proyecto y podremos subirlo al stage para luego hacer un commit con ese borrado.

Si usamos el método Git:

git rm <RUTA_FICHERO>

Git lo borra del sistema de ficheros y añada esa modificación al stage, ahorrándonos un paso respecto a la versión usando el sistema operativo.

Si queremos quitar un archivo del repositorio sin borrarlo del working directory:

git rm --cached <RUTA_FICHERO>

Esto es útil cuando llegado un momento queremos empezar a ignorar un fichero que antes estábamos siguiendo (el .gitignore aquí no serviría).

Tras “desversionar” lo que queremos, ahora sí podremos modificar el .gitignore para añadir ese fichero o ficheros que no queremos que Git versione.

Un commit siempre necesita un mensaje descriptivo (es obligatorio):

git commit -m "Mensaje"

Si queremos que abra el editor por defecto para que luego añadamos el comentario:

git commit

Como recomendación, en los mensajes de commit habría que evitar genéricos como “Cambios”, “Nuevo archivo”, “Correcciones”, “CSS”, “Merge”… A la hora de escribir un mensaje, tenemos que explicar bien qué modificaciones sufre el proyecto y de forma muy breve. El propósito es que cuando se quiera ver el log, se pueda entender perfectamente los cambios que ha sufri oel proyecto:

git log --oneline --branches --graph

Si queremos modificar el último commit (solo el último) que hemos hecho:

git commit --amend

Esto lo haremos tras añadir cambios al stage.

Al ejecutar el comando anterior, se abrirá el mensaje del último commit (el que queremos modificar) dándonos la posibilidad de modificarlo, si queremos.

Otra cosa que suele pasar mucho es que hayamos hecho un commit con un mensaje incorrecto o incompleto. Si queremos corregir este mensaje, pero no tenemos más cambios, no hace falta subir nada al stage, basta con ejecutar el siguiente comando:

git commit --amend -m "Nuevo mensaje"

Esta modificación cambia el hash del commit. Esto es normal porque este hash se genera a partir del contenido del título y otras cosas.

Iniciamos un repositorio git:

git init

git status

Subiremos al stage el fichero despedidas-en.json:

git add despedidas-en.json

git status

Hacemos commit:

git commit -m "Commit inicial"

git log --oneline --branches

git status

Subimos el fichero saludos-en.json al stage:

git add saludos-en.json

Hacemos el commit:

git commit -m "Añadidas traducciones de saludos"

git log --oneline --branches

Modificamos el fichero saludos-en.json. Ahora git reconocerá que hay un cambio en el working directory:

git status

Subimos el fichero al stage:

git add saludos-en.json

Hacemos el commit:

git commit -m "Añadida despedida"

Vemos el log:

git log --oneline --branches

Creamos un nuevo fichero en el working directory: lugares-en.json. También hacemos modificaciones en el fichero saludos-en.json. Git nos avisará de estos cambios.

git status

Añadiremos al stage solo dos ficheros:

git add lugares-en.json despedidas-en.json

Hacemos commit:

git commit -m "Añadido fichero de lugares y añadido saludo"

Vemos el log:

git log --oneline --branches

Subimos al stage saludos-en.json modificado.

git add saludos-en.json

Pero nos arrepentimos, y lo quitamos del stage:

git reset HEAD saludos-en.json

Git nos dirá que aún está pendiente el cambio de ese fichero en el working directory:

git status

Pero si queremos volver a la versión del último commit del fichero saludos-en.json:

git checkout -- .

• Artículo "How to Write a Git Commit Message" ("Cómo escribir el mensaje de un commit en Git")
• Artículo "When to make a Git commit" ("Cuándo hacer un commit en Git")
• Capítulo del libro Pro Git con una explicación sobre el comando git reset:
  • Inglés
  • Castellano
• Capítulo del libro Pro Git con una explicación sobre el Working Directory, el stage y el repositorio local:
  • Inglés
  • Castellano
• Capítulo del libro Pro Git con un resumen sobre cómo deshacer cosas en el Working Directory y en el stage:
  • Inglés
  • Castellano