GUÍA / GitHub
Git y GitHub para desarrolladores principiantes
Aprende los conceptos esenciales de Git y GitHub, cómo trabajar con repositorios, commits, branches, Pull Requests y un flujo profesional básico.
Introducción y objetivos
Git registra versiones de tu proyecto; GitHub aloja repositorios y ofrece herramientas de colaboración como issues y Pull Requests. Puedes usar Git sin GitHub. Aprenderás a guardar cambios comprensibles, compartirlos y revisar una integración sin confundir tu carpeta local con el remoto.
Requisitos y repositorio local frente a remoto
Instala Git, configura nombre y correo y crea una cuenta de GitHub. Usa un repositorio de práctica sin datos privados. El repositorio local vive en tu equipo y permite crear commits sin conexión. El remoto es otra copia: editar un archivo no lo sube automáticamente. Clonar descarga el repositorio y configura normalmente origin.
Commit, staging y branch
El área de staging selecciona qué cambios entran en el próximo commit. Un commit registra una versión con su mensaje y relación con el historial. Una branch es una referencia que permite desarrollar una línea de trabajo; no es una segunda carpeta. Usa git status y git diff para saber qué estás a punto de guardar.
git status
git diff
git switch -c docs/instrucciones-locales
git add README.md
git diff --staged
git commit -m "docs: explicar como iniciar el proyecto"Push y pull
Push envía tus commits al remoto. Pull obtiene cambios y los integra según tu configuración; no significa simplemente descargar archivos sueltos. En una rama sin divergencias, git pull --ff-only evita crear una integración inesperada. Si falla, revisa el historial con el equipo en vez de forzar el push.
git push -u origin docs/instrucciones-locales
git log --oneline -5Pull Request y merge
Después del push, abre un PR con una finalidad y pruebas claras. El PR es la conversación sobre el cambio; merge es la operación que lo integra. Una rama puede existir sin PR. Revisa comentarios, corrige en la misma rama y espera los controles que exija el repositorio antes de integrar.
Conflictos básicos
Un conflicto puede ocurrir cuando Git no logra combinar cambios, por ejemplo dos ediciones de la misma línea. Abre los archivos afectados, entiende qué necesita conservar cada versión y elimina los marcadores después de resolverlo. Ejecuta las pruebas, añade los archivos resueltos y completa la operación indicada por git status. No elijas “mi versión” a ciegas.
Buenas prácticas y errores comunes
Usa mensajes que expliquen la intención: “fix: evitar envío doble del formulario” aporta más que “cambios”. Agrupa una sola tarea por commit cuando sea posible. Revisa .gitignore antes de añadir dependencias generadas o archivos .env. Borrar un secreto del último archivo no lo elimina del historial: avisa al equipo y revócalo.
Qué practicar después
Completa este ciclo con un README: ticket, rama, edición, commit, push, PR, revisión y merge. Después actualiza main y confirma que contiene el cambio. En un repositorio descartable, modifica una línea desde dos ramas para practicar un conflicto sin comprometer el trabajo de otras personas.