Git · Guía práctica¶
Git es una herramienta de control de versiones. Nos permite guardar el historial de un proyecto, saber qué hemos cambiado, volver a versiones anteriores y trabajar con repositorios remotos como GitErcilla, GitHub o GitLab.
Idea principal
No trabajamos directamente «en GitHub». Git controla las versiones en nuestro equipo y un repositorio remoto nos permite guardar y compartir esos commits en un servidor.
1. Conceptos básicos¶
| Concepto | Qué significa |
|---|---|
| Repositorio | Proyecto cuyo historial controla Git. |
| Repositorio local | El repositorio que tenemos en nuestro equipo. |
| Repositorio remoto | El repositorio alojado en un servidor. |
| Commit | Punto guardado del historial del proyecto. |
| Staging | Zona donde preparamos los cambios que irán al siguiente commit. |
| Rama | Línea de trabajo independiente. La principal suele llamarse main. |
| Clone | Copiar un repositorio remoto a nuestro equipo. |
| Push | Enviar nuestros commits al remoto. |
| Pull | Traer e integrar cambios del remoto. |
| .gitignore | Archivo que indica qué archivos o carpetas no debe controlar Git. |
2. Instalación¶
Comprueba la instalación:
3. Configuración inicial¶
La primera vez indicamos el nombre y correo que aparecerán como autor de nuestros commits:
git config --global user.name "Nombre Apellidos"
git config --global user.email "correo@ejemplo.com"
Comprobar la configuración:
Note
--global aplica la configuración a todos los repositorios de ese usuario. La autenticación contra GitErcilla, GitHub u otro servidor se configurará según el método que utilicemos en clase; no es necesario guardar la contraseña dentro de la configuración de Git.
4. Dos formas de empezar¶
Opción A · Crear un repositorio desde un proyecto existente¶
Sitúate en la carpeta raíz del proyecto:
Comprueba su estado:
Opción B · Clonar un repositorio que ya existe¶
git clone descarga los archivos, el historial y la configuración del remoto.
5. El ciclo de trabajo diario¶
Este es el flujo que más utilizaremos:
1. Ver qué ha cambiado¶
2. Preparar los cambios¶
Un archivo concreto:
Todos los cambios:
3. Crear un commit¶
El mensaje debe explicar brevemente qué cambio contiene el commit.
4. Enviar los commits al servidor¶
La primera vez, si la rama todavía no está asociada al remoto, puede ser necesario:
6. Conectar un proyecto local con un remoto¶
Si hemos utilizado git init y después hemos creado un repositorio vacío en GitErcilla/GitHub:
Ver los remotos configurados:
7. Traer cambios¶
Antes de continuar un proyecto que también se ha modificado desde otro equipo:
Para descargar información del remoto sin integrarla todavía:
Trabajo en varios equipos
Si has trabajado desde casa y después continúas en clase, acostúmbrate a hacer git pull antes de empezar a modificar archivos.
8. .gitignore¶
.gitignore evita subir archivos generados, temporales, configuraciones locales o carpetas que no deben formar parte del repositorio.
Ejemplo:
Warning
Un archivo con contraseñas, tokens o claves no debe subirse al repositorio. Añadirlo después a .gitignore no borra automáticamente las copias que ya existan en el historial.
9. Ver historial y diferencias¶
Historial resumido:
Historial con ramas:
Cambios que todavía no hemos añadido a staging:
Cambios que ya están preparados para el próximo commit:
10. Ramas¶
Crear una rama y cambiar directamente a ella:
Ver las ramas:
Volver a la principal:
Integrar los cambios de otra rama en la actual:
Cuando la rama ya no sea necesaria:
11. Conflictos¶
Un conflicto aparece cuando Git no puede decidir automáticamente cómo combinar dos cambios.
El flujo habitual es:
1. Git indica los archivos con conflicto
2. Abrimos y corregimos esos archivos
3. git add ...
4. git commit
5. git push
Comprueba siempre qué archivos están afectados con:
12. Deshacer cambios sin complicarnos¶
Descartar cambios locales de un archivo que todavía no hemos añadido:
Sacar un archivo del staging sin borrar sus cambios:
Cuidado con los comandos destructivos
Comandos como git reset --hard pueden eliminar cambios locales. No los utilices como primera opción para «arreglar Git».
13. Comandos de consulta útiles¶
Estos comandos son seguros para consultar el estado del repositorio y son un buen punto de partida cuando no sabes qué está ocurriendo.
14. Flujo recomendado en clase¶
Al comenzar:
Trabaja normalmente y, cuando completes un cambio con sentido:
No esperes al final del proyecto para hacer un único commit. Es mejor crear commits pequeños y con sentido.
15. Chuleta rápida¶
| Quiero... | Comando |
|---|---|
| Ver el estado | git status |
| Clonar un repositorio | git clone URL |
| Traer cambios | git pull |
| Preparar todos los cambios | git add . |
| Crear un commit | git commit -m "mensaje" |
| Enviar commits | git push |
| Ver el historial | git log --oneline |
| Crear una rama | git switch -c nombre |
| Cambiar de rama | git switch nombre |
| Ver diferencias | git diff |