Guía de instalación de Git PDF

Git básico para trabajo remoto 1. Configuración inicial 1.1 Establecer el nombre del usuario 1.2 Establecer el correo electrónico del usuario 2. Inicializar o clonar repositorios 2.1 Crear un nuevo repositorio 2.2 Clonar un repositorio existente 3. Trabajando con archivos 3.1 Ver...

Git básico para trabajo remoto 1. Configuración inicial 1.1 Establecer el nombre del usuario 1.2 Establecer el correo electrónico del usuario 2. Inicializar o clonar repositorios 2.1 Crear un nuevo repositorio 2.2 Clonar un repositorio existente 3. Trabajando con archivos 3.1 Ver el estado actual de los archivos 3.2 Añadir archivos al staging 3.2.1 Añadir un archivo específico 3.2.2 Añadir todos los archivos modificados 3.3 Confirmar cambios (commits) 3.4 Ver historial de commits 4. Sincronización con repositorio remoto 4.1 Verificar remotos 4.2 Añadir un remoto 4.3 Subir cambios 4.4 Descargar cambios 5. Trabajar con ramas 5.1 Ver ramas disponibles 5.2 Crear una nueva rama 5.3 Cambiar a otra rama 5.4 Crear y cambiar a una nueva rama 6. Colaborar entre ramas 6.1 Comprobar diferencias entre ramas 6.2 Mantener la rama actualizada 6.3 Subir tu rama 7. Combinar cambios (merge) 7.1 Cambiar a la rama principal ( main ) 7.2 Asegurarse de que la rama principal está actualizada 7.3 Combinar cambios desde otra rama 7.4 Resolver conflictos si los hay 7.4.1 Ver conflictos 7.4.2 Editar archivos conflictivos 7.4.3 Añadir archivos tras resolver conflicto 7.4.4 Confirmar la resolución del conflicto 8. Buenas prácticas 8.1 Realizar commits con mensajes claros y descriptivos 8.2 Sincronizar tu rama con git pull antes de hacer cualquier cambio 8.3 Evitar commits grandes; hacer commits pequeños y frecuentes 8.4 Trabajar en ramas separadas para desarrollar nuevas características o corregir bugs 8.5 Combinar los cambios de otras ramas frecuentemente para evitar grandes conflictos 1. Configuración inicial 1.1 Establecer el nombre del usuario Este comando establece el nombre del usuario globalmente en las configuraciones de git para que sea utilizado en todos los repositorios. git config --global user.name "Tu Nombre" 1.2 Establecer el correo electrónico del usuario Este comando establece el correo electrónico del usuario globalmente en las configuraciones de git para que sea utilizado en todos los repositorios. git config --global user.email "[email protected]" Claro, entiendo lo que necesitas. A partir de ahora, al final de cada tema incluiré un glosario con las definiciones de palabras clave para reforzar el aprendizaje del vocabulario. Aquí tienes la versión ajustada del tema con las definiciones al final: 2. Inicializar o clonar repositorios 2.1 Crear un nuevo repositorio Cuando creas un nuevo proyecto, lo primero que debes hacer es inicializar un repositorio de Git en el directorio del proyecto. Esto le dice a Git que comience a rastrear los cambios en los archivos dentro de esa carpeta. El comando git init crea un repositorio vacío de Git en el directorio actual. Después de ejecutarlo, Git comenzará a rastrear los archivos en la carpeta. Este comando crea una carpeta oculta llamada.git , donde se almacenan todas las configuraciones y el historial de versiones del proyecto. Ejemplo: Si estás trabajando en un proyecto llamado "mi-proyecto", puedes ir a esa carpeta y ejecutar: cd mi-proyecto git init Después de ejecutar este comando, el directorio de tu proyecto se convierte en un repositorio de Git y puedes empezar a añadir archivos y hacer commits. 2.2 Clonar un repositorio existente Si el proyecto ya existe en un servidor remoto (como GitHub, GitLab, Bitbucket, etc.), en lugar de inicializar un repositorio vacío, puedes clonar el repositorio existente. Clonar significa que copiarás todo el historial del repositorio, incluyendo todas sus ramas, commits y archivos, en tu máquina local. El comando git clone te permite copiar un repositorio remoto a tu máquina local. Necesitas la URL del repositorio remoto para ejecutar este comando. Ejemplo: Si tienes un repositorio alojado en GitHub en la URL https://github.com/usuario/mi- proyecto.git , puedes clonarlo con el siguiente comando: git clone https://github.com/usuario/mi-proyecto.git Esto creará una nueva carpeta llamada mi-proyecto (o el nombre que le des) que contiene todos los archivos del proyecto y su historial de cambios. Puedes cambiar a esta carpeta y empezar a trabajar en el código: cd mi-proyecto Una vez que hayas clonado el repositorio, Git estará configurado para que puedas sincronizar cambios entre tu copia local y el repositorio remoto. Palabras clave Máquina local: El equipo (computadora) en el que estás trabajando directamente. Remoto: Un repositorio o recurso que está almacenado en un servidor externo, accesible a través de internet. Servidor: Un equipo remoto donde se almacenan datos y servicios, como un repositorio Git. Repositorio: Un espacio donde se almacena el código fuente y el historial de cambios ( commits ) de un proyecto. 3. Trabajando con archivos 3.1 Ver el estado actual de los archivos El comando git status te permite ver el estado actual de los archivos en tu repositorio. Este comando muestra cuáles archivos han sido modificados, cuáles están en el área de "staging" listos para ser confirmados, y cuáles no están siendo rastreados por Git. Ejemplo: git status Este comando es útil para obtener una visión clara de qué cambios se han hecho y qué archivos necesitas añadir o confirmar. 3.2 Añadir archivos al staging Antes de confirmar los cambios, debes añadir los archivos al área de "staging". Este proceso le dice a Git cuáles archivos deseas incluir en tu próximo commit. 3.2.1 Añadir un archivo específico Puedes añadir un archivo específico al área de staging con el siguiente comando: git add ARCHIVO Ejemplo: Si has editado un archivo llamado index.html , puedes añadirlo así:  git add index.html 3.2.2 Añadir todos los archivos modificados Si deseas añadir todos los archivos modificados al área de staging de una vez, puedes usar el siguiente comando: git add. 3.3 Confirmar cambios (commits) Después de añadir los archivos al área de staging , puedes confirmar los cambios (hacer un "commit"). Un commit es como un "punto de control" en el historial del proyecto. Cada commit lleva un mensaje que describe brevemente los cambios realizados. Ejemplo: git commit -m "Mensaje del commit" Es importante que el mensaje sea descriptivo y claro, para que otros desarrolladores (o tú en el futuro) puedan entender qué cambios se hicieron en ese commit. 3.4 Ver historial de commits Para ver el historial de commits de tu proyecto, puedes usar el comando git log. Este comando muestra una lista de commits realizados, junto con el autor, la fecha y el mensaje de cada commit. Ejemplo: git log Este comando te ayudará a ver el historial del proyecto y revisar los cambios que se han hecho en el pasado. Palabras clave Staging: El área donde se colocan los archivos que se quieren incluir en el próximo commit. Commit: Un "punto de control" que guarda los cambios en el repositorio con un mensaje descriptivo. Historial de commits: El registro de todos los commits hechos en un proyecto, que permite ver cuándo y por qué se hicieron cambios. No rastreado: Archivos que Git aún no está siguiendo ni incluyendo en el control de versiones. 4. Sincronización con repositorio remoto 4.1 Verificar remotos Para ver cuáles repositorios remotos están asociados con tu repositorio local, utiliza el comando git remote -v. Este comando lista las direcciones URL de los remotos que están configurados para "fetch" (obtener datos) y "push" (subir datos). Ejemplo:  git remote -v Este comando te muestra los nombres de los remotos (generalmente origin ) y las URLs asociadas. 4.2 Añadir un remoto Si tu repositorio local no tiene un remoto configurado, puedes añadir uno usando el comando git remote add. Un repositorio remoto es un lugar en línea donde puedes almacenar tu código, como GitHub o GitLab. Ejemplo: git remote add origin https://github.com/usuario/mi-proyecto.git Este comando añade un remoto llamado origin que apunta a la URL del repositorio en GitHub (o cualquier otro servicio remoto). Ahora podrás subir y descargar cambios de ese repositorio remoto. 4.3 Subir cambios Para subir tus cambios al repositorio remoto, utilizas el comando git push. Esto envía los commits desde tu rama local a la rama del repositorio remoto. Generalmente, origin es el nombre del repositorio remoto y NOMBRE_RAMA es la rama a la que estás subiendo los cambios (por ejemplo, main o develop ). Ejemplo: git push origin main Este comando sube los cambios de la rama main de tu máquina local al repositorio remoto. 4.4 Descargar cambios Para obtener los últimos cambios desde el repositorio remoto y aplicarlos en tu repositorio local, utilizas el comando git pull. Este comando trae los cambios y trata de fusionarlos con tu rama actual. Ejemplo: git pull origin main Este comando descarga los cambios desde la rama main del remoto origin y los fusiona con la rama main de tu máquina local. Palabras clave Remoto: Un repositorio en línea (GitHub, GitLab, etc.) donde se almacenan copias del código para colaborar y sincronizar cambios. Origin: El nombre por defecto del repositorio remoto cuando lo añades por primera vez. Fetch: El proceso de descargar información (como commits y ramas) de un repositorio remoto sin fusionarlos aún con tu copia local.  Push: El proceso de enviar los cambios confirmados desde tu repositorio local al repositorio remoto. Pull: El proceso de traer los cambios del repositorio remoto y fusionarlos con tu rama local. 5. Trabajar con ramas 5.1 Ver ramas disponibles Para ver todas las ramas disponibles en tu repositorio local, utiliza el comando git branch. Este comando muestra una lista de las ramas y marca con un asterisco ( * ) la rama en la que estás trabajando actualmente. Ejemplo: git branch Esto te permitirá ver en qué rama estás y qué otras ramas están disponibles en tu repositorio local. 5.2 Crear una nueva rama Puedes crear una nueva rama usando el comando git branch NOMBRE_RAMA. Las ramas se utilizan para trabajar en diferentes características o arreglos de manera independiente, sin afectar la rama principal o las demás ramas. Ejemplo: git branch nueva-rama Esto creará una rama llamada nueva-rama , pero no cambiará a ella automáticamente; sigues trabajando en la rama actual. 5.3 Cambiar a otra rama Para cambiar a una rama diferente, utiliza el comando git checkout NOMBRE_RAMA. Esto cambiará tu entorno de trabajo a la rama especificada, lo que significa que verás los archivos y cambios asociados a esa rama. Ejemplo: git checkout nueva-rama Este comando te moverá a la rama nueva-rama , donde puedes realizar cambios sin afectar la rama principal. 5.4 Crear y cambiar a una nueva rama Una manera eficiente de crear una nueva rama y cambiar a ella al mismo tiempo es usando git checkout -b NOMBRE_RAMA. Esto combina los pasos de creación y cambio de rama en un solo comando. Ejemplo:  git checkout -b nueva-rama Esto creará la rama nueva-rama y cambiará a ella automáticamente, lo que te ahorra tiempo si planeas comenzar a trabajar en la nueva rama de inmediato. Palabras clave Rama (branch): Una línea independiente de desarrollo que permite trabajar en cambios sin afectar la rama principal. Rama principal: La rama principal del proyecto, generalmente llamada main o master , donde se integran los cambios una vez que están listos para ser desplegados o compartidos. Checkout: El comando para cambiar de una rama a otra o volver a un estado anterior en el historial de cambios. Crear rama: El proceso de iniciar una nueva rama para trabajar en cambios específicos de manera aislada del resto del proyecto. 6. Colaborar entre ramas 6.1 Comprobar diferencias entre ramas Para ver las diferencias entre dos ramas, utiliza el comando git diff NOMBRE_RAMA_A NOMBRE_RAMA_B. Esto te permite comparar los cambios realizados en las dos ramas especificadas, lo que es útil para revisar qué modificaciones han ocurrido en cada rama antes de hacer una fusión (merge) o decidir qué cambios integrar. Ejemplo: git diff main develop Este comando te mostrará las diferencias entre las ramas main y develop. 6.2 Mantener la rama actualizada Es importante mantener tu rama actualizada con los últimos cambios del repositorio remoto para evitar conflictos más adelante. Utiliza el comando git pull origin NOMBRE_RAMA para descargar los cambios más recientes del repositorio remoto y fusionarlos en tu rama local. Ejemplo: git pull origin develop Este comando descarga los últimos cambios de la rama develop del repositorio remoto y los fusiona con tu copia local de esa rama. 6.3 Subir tu rama Una vez que hayas realizado cambios en tu rama local, puedes subir esos cambios al repositorio remoto usando el comando git push origin NOMBRE_RAMA. Esto hace que los cambios que has hecho en tu rama local estén disponibles para otros colaboradores en el repositorio remoto. Ejemplo:  git push origin develop Este comando sube los cambios en la rama develop a su correspondiente rama en el repositorio remoto. Palabras clave Diff: Un comando que compara los cambios entre dos versiones, ramas o commits, mostrando las diferencias línea por línea. Actualizar rama (pull): El proceso de traer los cambios del repositorio remoto y fusionarlos con la rama local. Subir rama (push): El proceso de enviar los cambios confirmados en tu rama local al repositorio remoto, haciéndolos accesibles para otros colaboradores. Colaboración entre ramas: Trabajar en diferentes ramas y luego compararlas, fusionarlas o sincronizarlas para integrar cambios de varios colaboradores. 7. Combinar cambios (merge) 7.1 Cambiar a la rama principal ( main ) Antes de combinar cambios desde otra rama, primero necesitas asegurarte de estar en la rama principal ( main o master ). Usa el comando git checkout main para cambiar a esa rama. Ejemplo: git checkout main Esto te coloca en la rama principal del proyecto, desde donde puedes combinar los cambios de otras ramas. 7.2 Asegurarse de que la rama principal está actualizada Es importante que la rama principal esté actualizada antes de hacer una fusión. Utiliza git pull origin main para descargar y fusionar cualquier cambio pendiente en la rama main desde el repositorio remoto. Ejemplo: git pull origin main Este comando asegura que la rama principal local tiene todos los últimos cambios desde el remoto. 7.3 Combinar cambios desde otra rama Para fusionar los cambios de una rama de desarrollo o característica en la rama principal, utiliza git merge NOMBRE_RAMA_DESARROLLO. Esto integrará los cambios de la rama de desarrollo en la rama actual (que debería ser main ). Ejemplo: git merge develop Este comando combina los cambios de la rama develop en la rama main. Si no hay conflictos, la fusión se completará sin intervención adicional. 7.4 Resolver conflictos si los hay A veces, durante el proceso de fusión, pueden surgir conflictos si los cambios en las dos ramas afectan las mismas líneas de un archivo. Git te avisará de estos conflictos y tendrás que resolverlos manualmente. 7.4.1 Ver conflictos Puedes usar git status para ver los archivos en los que se han generado conflictos. Ejemplo: git status Git te mostrará una lista de archivos en conflicto que necesitan ser revisados. 7.4.2 Editar archivos conflictivos Abre los archivos conflictivos y busca las marcas de conflicto ( > ). Estas marcas te muestran las diferencias entre las dos versiones. Debes elegir cuál versión mantener o combinar ambas. 7.4.3 Añadir archivos tras resolver conflicto Una vez que hayas resuelto los conflictos editando los archivos, añade los archivos corregidos al área de "staging" con git add. Ejemplo: git add archivo_conflictivo.txt 7.4.4 Confirmar la resolución del conflicto Después de añadir los archivos que has editado, confirma los cambios resolviendo los conflictos con un commit descriptivo. Ejemplo: git commit -m "Resuelto conflicto en archivo_conflictivo.txt" Este comando creará un commit con los cambios fusionados y la resolución de los conflictos. Palabras clave Fusión (merge): El proceso de combinar los cambios de una rama en otra. Conflicto: Una situación que ocurre cuando dos ramas modifican las mismas líneas en un archivo de manera diferente y Git no puede fusionarlas automáticamente. Marcas de conflicto: Símbolos ( > ) que indican en qué parte de un archivo hay un conflicto. Resolver conflictos: El proceso manual de editar archivos en conflicto para decidir qué cambios conservar y luego confirmar esos cambios. 8. Buenas prácticas 8.1 Realizar commits con mensajes claros y descriptivos Es importante que cada commit lleve un mensaje claro y descriptivo que explique los cambios realizados. Esto facilita la colaboración entre desarrolladores y la comprensión del historial del proyecto. Ejemplo: git commit -m "Corrige error en la función de login" Un buen mensaje de commit debe describir brevemente lo que cambiaste y por qué, para que otros (o tú mismo en el futuro) puedan entender los cambios. 8.2 Sincronizar tu rama con git pull antes de hacer cualquier cambio Antes de comenzar a trabajar en una rama, asegúrate de que está actualizada con el repositorio remoto. Utiliza git pull para traer los últimos cambios y evitar conflictos más adelante. Ejemplo: git pull origin develop Esto asegura que tu rama local esté alineada con los últimos cambios del remoto. 8.3 Evitar commits grandes; hacer commits pequeños y frecuentes Los commits pequeños y frecuentes son más fáciles de entender y depurar. Evita acumular muchos cambios en un solo commit, ya que esto dificulta el seguimiento del historial y la revisión de código. 8.4 Trabajar en ramas separadas para desarrollar nuevas características o corregir bugs Cada nueva característica o corrección de errores debe desarrollarse en una rama separada. Esto permite mantener el código principal estable y facilita la integración de cambios de manera controlada. Ejemplo: git checkout -b nueva-caracteristica Esto crea una nueva rama para trabajar en una característica sin afectar la rama principal. 8.5 Combinar los cambios de otras ramas frecuentemente para evitar grandes conflictos Para evitar conflictos grandes y complejos, es una buena práctica combinar los cambios de otras ramas con frecuencia. Esto mantiene las ramas actualizadas y reduce el riesgo de conflictos difíciles de resolver más adelante. Ejemplo:  git merge develop Combinar los cambios de otras ramas con frecuencia facilita el trabajo en equipo y mantiene las ramas sincronizadas. Palabras clave Mensaje de commit: Una breve descripción del propósito del commit, que ayuda a entender los cambios realizados. Sincronización (pull): Descargar los cambios más recientes del repositorio remoto y fusionarlos con tu rama local. Commit pequeño: Un cambio aislado y específico en el código, que facilita la revisión y el seguimiento. Ramas separadas: Trabajar en diferentes ramas para mantener el desarrollo organizado y evitar problemas en la rama principal. Conflicto: Una situación en la que los cambios en diferentes ramas no se pueden fusionar automáticamente. Guía de instalación de Git 1. Instalación en Windows 1.1 Descarga Git para Windows Ve al sitio oficial de Git: https://git-scm.com Descarga el instalador para Windows. 1.2 Ejecutar el instalador Una vez descargado el instalador, haz doble clic para ejecutarlo. Durante la instalación, se te presentarán varias opciones. A continuación te explicamos las más importantes: Editor predeterminado: Git permite elegir el editor de texto predeterminado para abrir y editar archivos de configuración. Si no tienes preferencia, puedes usar el editor que viene por defecto (Vim) o elegir uno que conozcas mejor (como Visual Studio Code). Ajustar el PATH: Selecciona la opción "Git from the command line and also from 3rd- party software" para poder usar Git desde cualquier terminal de Windows y aplicaciones externas. Configurar estilo de finalización de líneas: Selecciona "Checkout Windows-style, commit Unix-style line endings" para evitar problemas de compatibilidad de fin de línea entre sistemas operativos. 1.3 Verificar la instalación Una vez completada la instalación, abre un terminal o la consola de Git Bash e ingresa el siguiente comando para verificar que Git se haya instalado correctamente: git --version Si ves un mensaje con la versión instalada de Git, ¡la instalación fue exitosa! 2. Instalación en macOS 2.1 Usar Homebrew (recomendado) Si tienes Homebrew instalado, puedes instalar Git fácilmente ejecutando el siguiente comando en el terminal: brew install git 2.2 Verificar la instalación Después de instalar Git, verifica la instalación ejecutando: git --version Esto mostrará la versión de Git que has instalado. 3. Instalación en Linux 3.1 Ubuntu/Debian sudo apt update sudo apt install git 3.2 Fedora sudo dnf install git 3.3 Arch Linux sudo pacman -S git 3.4 Verificar la instalación Después de instalar Git, ejecuta el siguiente comando para verificar la versión instalada: git --version 4. Configuración inicial después de la instalación 4.1 Establecer nombre de usuario global Después de instalar Git, es recomendable configurarlo globalmente con tu nombre y correo electrónico para que se asocien con tus commits. git config --global user.name "Tu Nombre" 4.2 Establecer correo electrónico global git config --global user.email "[email protected]" 5. Recomendaciones adicionales Git Bash para Windows: Si estás en Windows, es recomendable usar Git Bash como tu terminal para Git. Viene incluido con la instalación de Git para Windows y proporciona una experiencia más cercana a la de un entorno Unix. Actualización periódica: Mantén tu instalación de Git actualizada para asegurarte de contar con las últimas mejoras y correcciones de seguridad. Puedes hacerlo desde la página oficial de Git o, en el caso de macOS y Linux, a través de Homebrew o el gestor de paquetes de tu distribución. Editor de texto: Elige un editor de texto cómodo para trabajar con Git. Recomendaciones populares incluyen Visual Studio Code, Sublime Text o Atom.