Guía técnica de Git: Instalación, configuración y flujo de trabajo desde cero

Git se ha consolidado como el sistema de control de versiones distribuido estándar en la industria del software. Su capacidad para gestionar cambios, facilitar el trabajo colaborativo y mantener un historial íntegro del código lo hace indispensable para cualquier desarrollador. Esta guía detalla el proceso de despliegue y uso fundamental en sistemas Windows, macOS y Linux.

1. Proceso de instalación por plataforma

Windows

Para entornos Windows, el método recomendado es utilizar el instalador oficial de Git for Windows. Durante el asistente, es crucial prestar atención a las siguientes configuraciones para garantizar un entorno estable:

  • Editor por defecto: Se recomienda seleccionar Visual Studio Code si ya está instalado, aunque Vim es la opción clásica.
  • Ajuste del PATH: Seleccione la opción "Git from the command line and also from 3rd-party software". Esto permite que herramientas como VS Code, IntelliJ o el CMD de Windows reconozcan los comandos de Git automáticamente.
  • Conversión de finales de línea: Elija "Checkout Windows-style, commit Unix-style line endings" para evitar conflictos de formato al colaborar con usuarios de Linux o Mac.

Para verificar la instalación, ejecute en la terminal: git --version.

macOS

En sistemas Apple, la forma más rápida es a través de las herramientas de línea de comandos de Xcode. Ejecute el siguiente comando en su terminal:

xcode-select --install

Alternativamente, si utiliza el gestor de paquetes Homebrew, puede instalarlo con: brew install git.

Linux

La mayoría de las distribuciones cuentan con Git en sus repositorios oficiales. Utilice el comando correspondiente a su gestor de paquetes:

# Para Ubuntu/Debian
sudo apt update && sudo apt install git -y

# Para Fedora/CentOS
sudo dnf install git -y

2. Configuración inicial del entorno

Antes de realizar el primer commmit, es obligatorio identificar al autor de los cambios. Esta configuración es global y solo debe realizarse una vez.

# Definir identidad del desarrollador
git config --global user.name "Tu Nombre"
git config --global user.email "usuario@ejemplo.com"

# Verificar la configuración actual
git config --list

3. Comandos esenciales y flujo de trabajo

El ciclo de vida de un archivo en Git transcurre por tres estados: Directorio de trabajo, Área de preparación (Staging) y Repositorio local.

Gestión de repositorios y archivos

# Iniciar un nuevo repositorio local
git init

# Descargar un proyecto existente desde un servidor remoto
git clone https://github.com/usuario/proyecto.git

# Consultar el estado de los archivos (modificados, nuevos o en staging)
git status

# Añadir cambios al área de preparación
git add archivo_especifico.js
git add . # Añade todos los cambios

Confirmación de cambios y ramas

Las confirmaciones (commits) crean una instantánea del proyecto, miantras que las ramas permiten desarrollar funcionalidades de forma aislada.

# Guardar cambios en el historial local
git commit -m "feat: implementar lógica de autenticación"

# Gestión de ramificaciones
git branch dev               # Crear rama 'dev'
git checkout dev             # Cambiar a la rama 'dev'
git checkout -b hotfix       # Crear y cambiar a la rama en un paso
git merge dev                # Fusionar 'dev' en la rama actual

Interacción con servidores remotos

# Vincular el repositorio local con uno remoto
git remote add origin https://servidor.com/repo.git

# Enviar cambios al servidor
git push origin main

# Actualizar el repositorio local con los cambios del servidor
git pull origin main

4. Flujo de trabajo práctico: De local a la nube

A continuación, se presenta la secuencia lógica para subir un proyecto local a un repositorio remoto por primera vez:

# 1. Preparar el entorno local
git init
git add .
git commit -m "Initial commit: estructura base del proyecto"

# 2. Conectar y sincronizar
git remote add origin https://github.com/mi-usuario/mi-app.git
git branch -M main
git push -u origin main

5. Resolución de incidencias comunes

  • Conflicto de fusión: Ocurre cuando dos personas editan la misma línea. Git marcará el archivo; debe editarlo manualmente para elegir la versión correcta, luego ejecutar git add y git commit.
  • Error de comandos no reconocidos: Generalmente se debe a que la ruta de Git no se agregó al PATH del sistema. Reinstale asegurándose de marcar la opción de integración con la consola.
  • Problemas con caracteres especiales: Si los nombres de archivos con tildes o eñes se muestran incorrectamente, ejecute: ``` git config --global core.quotepath false

Etiquetas: Git Version Control DevOps Software Development

Publicado el 7-21 08:53