Guía Completa: Cómo Subir tu Primer Proyecto a GitHub

Guía Completa: Cómo Subir tu Primer Proyecto a GitHub

Introducción a GitHub

GitHub es una plataforma de desarrollo colaborativo que utiliza el sistema de control de versiones Git. Es el lugar perfecto para alojar tus proyectos, colaborar con otros desarrolladores y mostrar tu trabajo al mundo.

Pasos para subir tu primer proyecto

1. Instala Git

Si aún no tienes Git instalado, descárgalo desde git-scm.com.

2. Configura tu identidad

Abre una terminal o línea de comandos y configura tu nombre de usuario y correo electrónico:

git config --global user.name "Tu Nombre"
git config --global user.email "tu@email.com"

3. Crea un nuevo repositorio en GitHub

  1. Inicia sesión en GitHub
  2. Haz clic en el botón ”+” en la esquina superior derecha
  3. Selecciona “New repository”
  4. Dale un nombre a tu repositorio
  5. Añade una descripción (opcional)
  6. Elige si será público o privado
  7. Haz clic en “Create repository”

4. Inicializa Git en tu proyecto local

Navega a la carpeta de tu proyecto en la terminal y ejecuta:

git init

5. Añade tus archivos al área de preparación

git add .

6. Crea tu primer commit

git commit -m "Primer commit"

7. Conecta tu repositorio local con GitHub

Copia la URL de tu repositorio en GitHub (termina en .git) y ejecuta:

git remote add origin URL_DEL_REPOSITORIO

8. Sube tu código a GitHub

git branch -M main
git push -u origin main

Comandos Git esenciales

  • git status: Muestra el estado de tus archivos
  • git add .: Añade todos los archivos al área de preparación
  • git commit -m "mensaje": Guarda los cambios con un mensaje descriptivo
  • git push: Sube los cambios a GitHub
  • git pull: Obtiene los cambios del repositorio remoto

Buenas prácticas

  1. Commits atómicos: Cada commit debe representar un cambio lógico y único
  2. Mensajes descriptivos: Usa mensajes claros que expliquen qué cambiaste
  3. .gitignore: Crea un archivo .gitignore para excluir archivos innecesarios
  4. Ramas: Usa ramas para desarrollar nuevas características sin afectar el código principal

Solución de problemas comunes

  • Error de autenticación: Asegúrate de tener configurado correctamente tu token de acceso personal
  • Conflicto de ramas: Si recibes un error al hacer push, intenta hacer un pull primero
  • Archivos grandes: GitHub tiene un límite de 100MB por archivo, usa Git LFS si necesitas manejar archivos grandes

Conclusión

¡Felicidades! Ahora sabes cómo subir tu primer proyecto a GitHub. Recuerda que la práctica hace al maestro, así que sigue experimentando y mejorando tus habilidades con Git y GitHub.

Recursos adicionales