Git_and_GitHub

📌 Introducción general

Estas notas están pensadas para reunir lo más importante sobre Git y GitHub, dos herramientas clave en el mundo del desarrollo. Git nos permite llevar un control preciso de los cambios en nuestros proyectos, mientras que GitHub facilita el trabajo en equipo y la colaboración en línea.

➡️ Aquí vas a encontrar explicaciones con ejemplos, analogías y comandos prácticos que ayudan a recordar mejor el funcionamiento de estas herramientas, especialmente útil si estás empezando o necesitas repasar.

✏️ Estas notas no son formales ni académicas. Son apuntes que armé por mi cuenta mientras aprendía, explicados como me hubiera gustado que me los explicaran.

🔍 ¿Qué contiene este repositorio?

• 📖 Introducción conceptual a Git y GitHub
• 🧠 Comandos esenciales con explicaciones claras
• 🌿 Gestión de ramas, stash, tags, reset y reflog
• 🔐 Autenticación con SSH en GitHub
• 🤝 Uso de Pull Requests, forks y buenas prácticas
• 💡 ¿Por qué hice esto?

Aprender Git y GitHub desde cero puede parecer intimidante. Esta guía nace de mi propia necesidad de comprenderlo todo de forma simple, visual y útil. Lo comparto por si alguien más encuentra aquí algo que le sirva o le ayude a entender mejor.

🧩 Recomendado para:

• Estudiantes de desarrollo web o software
• Personas que están iniciando en proyectos colaborativos
• Developers que quieren tener una guía de repaso práctica

✅ ¿Qué hace especial a esta guía?

✅ Está explicada con ejemplos simples y reales

✅ Usa analogías para facilitar la comprensión

✅ Tiene un enfoque minimalista y directo

✅ No está sobrecargada con teoría innecesaria

---

Introducción a Git

Concepto de Git

Git es un sistema de control de versiones distribuido. Esto nos ayuda a documentar y trazar cada uno de los cambios que nosotros como desarrolladores realicemos.

Ej: Funciona como los mensajes de WhatsApp, en donde nosotros podemos ver todos los mensajes anteriores.

Git es un sistema de control de versiones distribuido diseñado para rastrear cambios y coordinar el trabajo colaborativo en proyectos de software.

Conceptos clave de Git

• Control de versiones: Registra el historial de cambios en archivos, permitiendo revertir, compartir y recuperar versiones anteriores.
• Distribuido: Cada desarrollador tiene una copia completa del repositorio, lo que permite trabajar sin conexión y facilita la redundancia

NOTA: Sistemas operativos como LInux y MacOS ya tienen Git instalado por defecto aún que puede que no sea la ultima versión.

Comandos de Git

NOTA: Como recomendación, hay que habilitar la opción de poder visualizar los archivos y carpetas ocultos en nuestro sistema operativo.

En Linux se hace con Ctrl + H.

• git init: Inicializa un repositorio con la herramienta de Git.

NOTA: Cuando en un directorio nos encontramos con un directorio oculto ".git" eso quiere decir que ese directorio ya a sido o esta siendo trabajado con el control de versiones de Git.

Ramas en Git

La rama master o main es la rama base sobre la cual esta montada el proyecto principal.

• git add: Nos permite agregar archivos y/o carpetas a nuestro proyecto principal inicializado en Git.
• git commit: Nos permite subir/insertar el cambio realizado con su respectivo identificador.
• git status: Nos permite evaluar el estado actual del repositorio (archivos modificados, en Staging Area [listo para commit], no rastrados [untrancked]).
• git log: Nos muestra el historial de commits (autor, fecha, mensaje y hash) en un orden cronológico inverso (más recientes primero).
  • git log --graph: Incluye un gráfico de las ramas.
• git checkout: Nos sirve principalmente para:
  • Cambiar de rama.
  • Restaurar archivos a un estado anterior (sin afectar commits).

git checkout "nombre-de-rama"
git checkout "nombre-archivo"

• git seter: Nos permite deshacer cambios en diferentes niveles.
  1. Quitar archivos de Staging Area (sin borrar los cambios).
  2. Eliminar commits locales.

git reset --soft HEAD~1

Deshace le ultimo commit pero mantiene los cambios en Staging Area. Utilizado para reescribir un commit (olvidaste incluir archivos).

Alias en Git

Los alias en Git son atajos personalizados que puedes crear para comandos largos o usados frecuentemente.

¿Para qué sirven?

• Acortar comandos complejos.
• Evitar errores de tipeo.
• Automátizar tareas repetitivas.

¿Cómo puedo crear un alias?

Sintaxis

git config --global alias.nombre-del-alias "comando-original"

¿Cómo ver todos los alias existentes?

git config --get-regexp alias

¿Cómo eliminar un alias?

git config --global --unset alias.nombre-del-alias

Ejemplo de la creación de alias típicos

.gitignore

El archivo .gitignore es un archivo de texto que le indica a Git que archivos o directorios debe ignorar en el repositorio. Es especialmente útil para excluir archivos generados automáticamente, temporales o sensibles que no deben incluirse en el control de versiones.

Ej:

# Igonorar archivos log
*.log

¿Donde se coloca?

• En la raíz del proyecto.
• También puedes tener archivos .gitignore en subdirectorios para reglas especificas.

git diff

• git diff: Nos permite visualizar todos los cambios realizados que no hayan sido guardados en el Working Directory.
• Muestra las modificaciones actuales (sin usar git add).
• Es ideal para revisar que cosas se han editado antes de preparar archivos para hacer commit

Desplazamiento en una rama (Moverse entre commits)

En Git el desplazamiento en una rama se refiere a moverse entre diferentes commits dentro del historial de una rama.

Esto permite inspeccionar, modificar o recuperar estados anteriores del proyecto.

1.- Conceptos clave

• HEAD: Es un apuntador que indica tu posición actual en el historial.
• Rama (Branch): Secuencia lineal de commits que representa una linea de desarrollo.
• Commit (HASH): Identificador único que representa un estado guardado del proyecto (Ej: a1b2c3d).

2.- Comandos para desplazarse

• gig checkout: Permite moverse a un commit en especifico (sin modificar la rama).

git checkout "hash-del-commit"

Para regresar a tu rama principal

git checkout "nombre-de-la-rama"

Git reset --hard & Git reflog

• git reset --hard: Borra todo lo que no esta guardado en un commit.
  • Cambios en tus archivos
  • Commits recientes Puedes mover tu rama a un commit anterior (es como retroceder en el tiempo).

¿Cuándo usarlo?

• Cuando quieres hacer commits locales.
• Cuando todo esta tan mal que quieres volver a un punto seguro.

git reset --hard "hash-del-commit"

• git reflog: Muestra todo lo que has hecho en git (incluso lo que borraste).

¿Cuándo usar git reflog?

• Si borraste un commit por error (con git reset --hard o git rebase).
• Si usaste un merge/rebase y todo se rompo y quieres volver atrás.
• Si accidentalmente borraste una rama y necesitas recuperar su ultimo commit.

¿Cómo usarlo?

Situación: Borraste los dos últimos commits con git reset --hard HEAD~2 y te arrepentiste.

1. Usa git reflog para encontrar los últimos hashes de los commits borrados.
2. Selecciona el hash del commit al que quieres volver (Ej: f4e5dec)
3. Recuperalo con:

git reset --hard f4e5dec

Tags en Git

¿Qué son las Tags en Git?

Los tags son como "marcadores" o "versiones oficiales" que se colocan en commits específicos para señalar puntos importantes en el historial del proyecto (Ej: lanzamiento de la versión como v1.0.0, v2.3.0).

Analogía

Imagina que tu proyecto es un libro. Los commits son las páginas y los tags son "post-it" pegados a páginas clave como "Capitulo 1" o "Edición FInal".

Tipos de Tags

• Lightwight Tags Son etiquetas simples (solo un nombre apunto a un commit).

git tag V1.0.1

• Annotated Tags Incluyen metadatos (autor, fecha, mensaje descriptivo y firma PGG)

git tag -a V2.0.0 -m "mesanje"

NOTA: Con Git tag podemos ver todas nuestras etiquetas creadas.

Ramas en Git

Las ramas en Git son lineas de desarrollo independientes que permiten trabajar en diferentes características, creaciones o experimentos sin afectar el código principal.

Analogía

Imagina un árbol.

• El tronco principal (main o master) es la versión estable.
• Las ramas son derivaciones donde puedes probar cosas nuevas sin romper el tronco.

¿Cómo funcionan?

1. Cada rama apunta a un commit especifico.
2. Los cambios de una rama son **aislados: No se afectan otras ramas hasta que se fusionan (merge).
3. Puedes crear, eliminar o fusionar ramas en cualquier momento.

Comandos esenciales

1. git branch (gestiona ramas) Se pueden ver, crear o eliminar ramas.

Comando	Descripción
git branch	Lista todas las ramas (indica la actual)
git branch "nombre-rama"	Crea una rama nueva (pero no cambia a ella)
git branch -d "nombre-rama"	Borra una rama local (si ya fue fusionada)
git branch -D "nombre-rama"	Fuerza el borrado (aunque no este fusionada)

2. git switch (cambia entre ramas)

   Moverse entre ramas existentes.

Comando	Descripción
git swith "nombre-rama"	Cambia a la rama especificada
git switch -c "nombre-rama"	Crea una rama nueva y cambia a ella.

3. git merge (fusionar ramas) Combina los cambios de una rama a otra (Ej: traer "login" a "main")

Pasos típicos

1. Posicionarte en la rama destino (Ej: "main")

git switch main

2. Fusionar la rama deseada.

git merge login

Stash en Git

¿Qué es el Stash en Git?

El stash es un "cajon temporal" donde git guarda cambios no guardados (en el Workging Directory o en el Staging Area) para que puedas cambiar de ramas sin perder los cambios.

Analogía

Imagina que estas escribiendo un documento y alguien te interrumpe. En lugar de guardarlo como versión final (commit) lo dejas en un post-it (stash) para recordarlo más tarde.

Comandos esencia