Cómo usar Git y GitHub: Guía completa para principiantes

Git es un sistema de control de versiones distribuido, creado en 2005 por Linus Torvalds, el mismo creador del kernel de Linux. Su principal propósito es permitir a los desarrolladores llevar un registro completo y detallado de los cambios en el código de un proyecto, lo que facilita la colaboración y mejora la eficiencia en el desarrollo de software.

Principales características de Git

• Distribuido: A diferencia de los sistemas de control de versiones centralizados (como Subversion o CVS), en Git cada desarrollador tiene una copia completa del proyecto en su máquina local. Esto incluye el historial de cambios y permite que se realicen modificaciones sin depender de una conexión constante a internet ni de un servidor central.

• Historial detallado: Git registra cada cambio de código en forma de “commits”. Cada commit representa una versión específica del proyecto y permite a los desarrolladores ver qué cambió, cuándo y quién realizó el cambio. Esto resulta útil para volver a versiones anteriores, investigar errores y comprender la evolución del proyecto.

• Optimización para proyectos grandes y equipos: Git fue diseñado para ser rápido y eficiente, incluso en proyectos de gran escala con miles de archivos y muchos contribuyentes. Esta es una de las razones por las que se ha convertido en la herramienta estándar en la industria de desarrollo de software.

Por qué es importante Git en el desarrollo moderno

Imagina que trabajas en un equipo de desarrolladores que colabora en un proyecto de software. Sin Git, cada desarrollador tendría que llevar un registro manual de los cambios, lo cual es propenso a errores y conflictos. Git facilita la colaboración al permitir que cada miembro del equipo trabaje en su propia “rama” o versión del proyecto sin interferir en el trabajo de los demás. Además, Git permite “fusionar” estas ramas, combinando los cambios realizados por cada desarrollador.

Por ejemplo, si tres desarrolladores están trabajando en tres funciones distintas de un mismo proyecto, cada uno puede desarrollar y probar su parte en una rama independiente. Luego, pueden fusionar sus ramas en la rama principal del proyecto, donde todos los cambios se combinan y se convierten en parte de la versión final.

Git también permite revertir cambios, lo cual es útil si se introducen errores en el código. Al tener un historial de versiones, se puede regresar a una versión anterior del proyecto sin afectar el trabajo realizado en otras áreas del código.

Qué es GitHub y cómo se relaciona con Git

GitHub es una plataforma de desarrollo colaborativo basada en la nube que permite almacenar y gestionar repositorios Git de forma remota. Mientras que Git es la herramienta de control de versiones que utilizas para gestionar el código localmente en tu equipo, GitHub es el servicio que te permite almacenar y compartir ese código con otros desarrolladores.

Funciones principales de GitHub

GitHub ofrece numerosas funcionalidades que facilitan el trabajo colaborativo:

• Almacenamiento remoto en la nube: Puedes almacenar una copia de tu proyecto en GitHub y acceder a él desde cualquier lugar con conexión a internet.

• Colaboración a través de Pull Requests: GitHub permite a los desarrolladores proponer cambios a un proyecto mediante “Pull Requests”. Un Pull Request permite a los colaboradores enviar sus contribuciones, y los propietarios del proyecto pueden revisarlas, comentarlas y, si están de acuerdo, integrarlas en el proyecto.

• Gestión de Issues: Los Issues son una herramienta que permite a los usuarios reportar problemas o proponer nuevas funcionalidades. Los desarrolladores pueden utilizar Issues para gestionar el progreso del proyecto, asignar tareas y discutir soluciones.

• Interfaz web para la administración de repositorios: GitHub simplifica muchas de las operaciones de Git mediante una interfaz gráfica en el navegador. Esto resulta útil para quienes se inician en Git o prefieren una interfaz más visual.

Diferencias entre Git y GitHub

Aunque suelen mencionarse juntos, Git y GitHub son herramientas distintas que cumplen funciones complementarias en el desarrollo de software.

En resumen, Git es la herramienta que permite gestionar el historial de versiones del código, mientras que GitHub proporciona el espacio y las herramientas para compartir, colaborar y almacenar repositorios de Git de forma remota.

Instalación de Git

Para comenzar a usar Git, es necesario instalarlo en tu sistema. A continuación, se detallan los pasos para los sistemas operativos más comunes.

Instalación de Git en Windows

• Dirígete al sitio oficial de Git en git-scm.com y descarga el instalador para Windows.
• Ejecuta el archivo descargado y sigue las instrucciones en pantalla. Durante el proceso de instalación, Git te ofrecerá varias opciones de configuración. La configuración predeterminada es adecuada para la mayoría de los usuarios.
• Al finalizar la instalación, abre una terminal de comandos (por ejemplo, Git Bash, que se instala junto a Git) para verificar que Git se instaló correctamente.

# Verificar la versión de Git (Windows)
git --version

Instalación de Git en macOS

• La forma más sencilla de instalar Git en macOS es usando el sistema de gestión de paquetes Homebrew. Si aún no tienes Homebrew instalado, puedes instalarlo con el siguiente comando en la terminal:

# Instalar Homebrew en macOS
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

• Una vez que tengas Homebrew, instala Git ejecutando:

# Instalar Git en macOS con Homebrew
brew install git

• Después de instalar Git, verifica la instalación con el siguiente comando:

# Instalar Git en macOS con Homebrew
brew install git

Instalación de Git en Linux

En la mayoría de las distribuciones de Linux, Git se puede instalar directamente desde el gestor de paquetes del sistema.

• Para distribuciones basadas en Debian (como Ubuntu):

# Instalar Git en distribuciones Debian/Ubuntu
sudo apt update
sudo apt install git

• Para distribuciones basadas en Red Hat (como Fedora o CentOS):

# Instalar Git en distribuciones Fedora/CentOS
sudo dnf install git

Después de la instalación, verifica que Git esté correctamente instalado:

# Verificar la versión de Git en Linux
git --version

Configuración inicial de Git

Una vez instalado Git, es necesario configurarlo con algunos datos básicos, como el nombre de usuario y el correo electrónico, que se asociarán a los cambios que realices en tus proyectos. Esta configuración se realiza una sola vez y permite que tus contribuciones queden identificadas correctamente.

• Configura tu nombre de usuario global:

# Configurar el nombre de usuario global en Git
git config --global user.name "Tu Nombre"

• Configura tu correo electrónico global:

# Configurar el correo electrónico global en Git
git config --global user.email "tu-email@ejemplo.com"

• Puedes confirmar la configuración de Git ejecutando el siguiente comando:

# Confirmar la configuración de Git
git config --list

Verificación de la instalación

Para confirmar que Git está instalado y configurado correctamente, abre una terminal y ejecuta:

# Verificar instalación de Git
git --version

Si Git responde mostrando el número de versión, significa que está correctamente instalado. También puedes ejecutar:

# Ver configuración de Git
git config --list

Este comando te mostrará el nombre de usuario y el correo electrónico configurados, junto con cualquier otra configuración personalizada que hayas establecido en Git.

Conceptos esenciales de Git y GitHub

Qué es un repositorio

Un repositorio es un espacio o contenedor donde se almacena todo el código de un proyecto, junto con su historial de versiones. En Git, el repositorio guarda todos los archivos y carpetas del proyecto, así como la información de cada cambio que se ha realizado. Gracias a esto, los desarrolladores pueden volver a versiones anteriores o colaborar en paralelo sin conflictos.

Existen dos tipos principales de repositorios en Git:

• Repositorios locales: Se almacenan en la máquina del usuario y permiten trabajar sin conexión.
• Repositorios remotos: Se encuentran en servidores externos, como los de GitHub, y sirven para almacenar y compartir el proyecto de manera centralizada, facilitando la colaboración en equipo.

Commits y seguimiento de versiones

Un commit es una “captura” o punto específico en el tiempo de un proyecto, que guarda el estado de los archivos en ese momento. Los commits permiten documentar y registrar los cambios realizados en el proyecto, creando un historial de versiones que puede consultarse y revertirse cuando sea necesario.

Cada commit incluye:

• Un identificador único: Este identificador permite distinguir cada commit en el historial del proyecto.
• Un mensaje descriptivo: Explica qué cambios se hicieron, ayudando a entender la evolución del proyecto.

Los commits son esenciales para realizar un seguimiento detallado de las modificaciones, y permiten a los desarrolladores entender qué se ha hecho en cada etapa.

# Realizar un commit en Git
git commit -m "Descripción de los cambios realizados"

Branches o ramas

Las ramas son una característica fundamental en Git para facilitar el trabajo colaborativo. Una rama es, en esencia, una línea de desarrollo separada, lo que permite trabajar en diferentes versiones del proyecto de manera independiente. Esto es especialmente útil cuando se desarrollan nuevas funciones o se realizan pruebas, ya que cada desarrollador puede trabajar en su propia rama sin afectar la versión principal del proyecto (conocida como la rama main o master).

Las ramas permiten:

• Experimentar sin riesgo: Puedes desarrollar y probar nuevas ideas sin afectar el código en producción.
• Colaborar de manera organizada: Cada desarrollador puede trabajar en una función o corrección específica en su propia rama, y luego integrar los cambios en la rama principal.
• Mantener un historial claro: Al usar ramas, el historial de cambios es más fácil de seguir, ya que las funcionalidades se desarrollan de manera independiente y luego se combinan en un solo flujo.

# Crear una nueva rama en Git
git branch nombre-de-la-rama

# Cambiar a una rama en Git
git checkout nombre-de-la-rama

Comandos básicos de Git

git init

El comando git init permite inicializar un nuevo repositorio en Git. Este comando crea una carpeta .git dentro del directorio actual, donde se almacenará toda la información necesaria para el control de versiones. Este es el primer paso cuando se comienza a trabajar en un proyecto nuevo y permite a Git llevar un seguimiento de los cambios.

# Inicializar un repositorio con git init
git init

git clone

El comando git clone se usa para crear una copia de un repositorio remoto en tu máquina local. Esto es útil para trabajar en proyectos alojados en GitHub, ya que permite descargar una copia completa del código y su historial de versiones para realizar modificaciones.

• URL del repositorio: Al clonar, debes especificar la URL del repositorio remoto (por ejemplo, el enlace del proyecto en GitHub).
• Copia completa del historial: Git descarga todo el historial de cambios del proyecto, permitiendo que trabajes sin conexión y accedas a versiones anteriores si es necesario.

# Clonar un repositorio de GitHub
git clone https://github.com/usuario/repositorio.git

git add y git commit

Estos dos comandos se utilizan juntos para registrar los cambios realizados en el código. Primero, git add selecciona los archivos o cambios específicos que deseas registrar, y luego git commit guarda estos cambios en el historial del proyecto.

• git add: Añade cambios al “staging area” o área de preparación. Esto permite elegir qué cambios quieres registrar en el próximo commit.
• git commit: Crea un commit con los cambios seleccionados. Cada commit debe incluir un mensaje descriptivo que explique las modificaciones realizadas.

# Añadir cambios específicos al área de preparación
git add nombre-del-archivo

git status y git log

• git status: Muestra el estado actual del repositorio, indicando qué archivos han sido modificados, cuáles están listos para ser confirmados y cuáles aún no están controlados por Git.

• git log: Muestra el historial de commits del proyecto. Este comando es útil para revisar los cambios realizados y permite navegar por el historial de versiones del repositorio.

# Consultar el estado del repositorio
git status

# Ver el historial de commits
git log

Gestión de ramas en Git

Crear y cambiar de rama

Las ramas permiten trabajar en diferentes versiones del proyecto de manera simultánea, lo cual es ideal para desarrollar nuevas funciones sin afectar el código principal. La rama principal suele llamarse main o master, y cualquier rama adicional puede crearse para trabajar en funcionalidades específicas o experimentos.

• Para crear una nueva rama, usa el comando git branch.
• Para cambiar de una rama a otra, utiliza git checkout.

# Crear una nueva rama en Git
git branch nombre-de-la-rama

# Cambiar a una rama en Git
git checkout nombre-de-la-rama

Fusión de ramas (git merge)

Cuando finalizas el trabajo en una rama y quieres integrar los cambios en la rama principal o en otra rama, usas el comando git merge. Este comando toma los cambios de una rama y los combina con otra. La fusión es uno de los pasos finales al desarrollar una nueva funcionalidad, ya que permite consolidar los cambios en una única versión del proyecto.

# Fusionar la rama actual con otra rama (en este ejemplo, la rama "nombre-de-la-rama")
git merge nombre-de-la-rama

Solución de conflictos

A veces, al fusionar dos ramas, pueden aparecer conflictos si ambas ramas han modificado las mismas líneas de código de forma diferente. Git no puede decidir automáticamente qué versión conservar, por lo que requiere la intervención del desarrollador para resolver el conflicto manualmente.

• Git marcará los archivos en conflicto y señalará las diferencias entre las versiones.
• Luego, deberás editar estos archivos y elegir qué cambios conservar.
• Una vez resuelto el conflicto, es necesario confirmar los cambios.

# Marcar conflictos como resueltos y confirmar la resolución
git add nombre-del-archivo
git commit -m "Resolver conflicto en nombre-del-archivo"

Eliminar ramas

Una vez que el trabajo en una rama ha finalizado y los cambios se han fusionado, puedes eliminar esa rama para mantener el proyecto organizado. La eliminación de ramas evita la acumulación de ramas obsoletas y facilita la navegación en el repositorio.

# Eliminar una rama localmente una vez que ya no es necesaria
git branch -d nombre-de-la-rama

Trabajar con GitHub: Primeros pasos

Crear un repositorio en GitHub

Para alojar un proyecto en GitHub, primero necesitas crear un repositorio en la plataforma. Un repositorio en GitHub actúa como un contenedor para tu proyecto y su historial de cambios.

• Accede a tu cuenta de GitHub y selecciona la opción New repository.
• Especifica un nombre para el repositorio y selecciona si quieres que sea público o privado.
• Puedes elegir iniciar el repositorio con un archivo README, lo cual facilita agregar una descripción del proyecto.

# Crear un archivo README para inicializar el repositorio en GitHub (opcional)
echo "# Mi Proyecto" >> README.md
git init
git add README.md
git commit -m "Primer commit con README"

Subir un repositorio local a GitHub

Si ya tienes un repositorio local en tu máquina y quieres alojarlo en GitHub, pue