La primera vez que abrí GitHub me sentí como si hubiera aterrizado en otro planeta. Había botones raros, palabras como 'pull request' y 'merge', y todo el mundo parecía saber lo que hacía menos yo. Lo peor es que los tutoriales que encontré asumían que ya sabías programar o que eras un experto en terminal. Pero la realidad es que solo necesitas saber cuatro cosas para empezar, y el resto lo aprendes sobre la marcha.
Aprende GitHub desde cero: lo que nadie te explica
Respuesta Rápida
GitHub es una plataforma para almacenar y compartir código usando Git. Este artículo te enseña lo básico: crear cuenta, subir proyectos y colaborar sin morir en el intento.
desarrollador y mentor de principiantes
"Hace dos años, en mi primer trabajo como desarrollador junior, me pidieron que subiera un proyecto a GitHub y casi renuncio. Pasé tres horas intentando hacer un 'push' y todo terminó en un error que no entendía. Al final, un compañero me mostró que solo necesitaba escribir 'git push origin main' y listo. Desde entonces, he ayudado a media docena de amigos a dar sus primeros pasos sin tanto drama."
🔍 Por qué sucede esto
El problema con GitHub es que mezcla dos cosas: el sistema de control de versiones Git (que es complejo) y la interfaz web (que es sencilla). La mayoría de tutoriales te explican Git con comandos desde el primer minuto, y eso asusta. Pero la verdad es que puedes hacer el 80% de las tareas básicas desde la web de GitHub sin tocar el terminal. Solo necesitas entender tres conceptos: repositorio, commit y rama.
🔧 5 Soluciones
1
Crea tu cuenta y explora la interfaz sin miedo
Regístrate en GitHub y familiarízate con las secciones principales.
-
1
Regístrate en github.com — Ve a github.com y crea una cuenta con tu correo. Elige un nombre de usuario que usarás en tus proyectos (ej: 'tu-nombre-dev'). Verifica tu correo.
-
2
Personaliza tu perfil — Sube una foto, añade tu nombre y una breve descripción. No es obligatorio, pero ayuda a que otros te reconozcan.
-
3
Crea tu primer repositorio — Haz clic en el botón verde 'New' al lado de 'Repositories'. Ponle nombre a tu proyecto (ej: 'mi-primer-proyecto'), selecciona 'Public' y marca 'Add a README file'.
-
4
Explora las pestañas — Dentro de tu repositorio, revisa las pestañas: Code (código), Issues (tareas), Pull Requests (cambios propuestos), Actions (automatización). No te preocupes si no entiendes todo.
El README es tu carta de presentación. Escribe qué hace tu proyecto, cómo instalarlo y un ejemplo básico. Usa el formato Markdown (los # para títulos, * para listas).
Producto Recomendado
GitHub For Dummies
Por qué ayuda: Este libro explica GitHub desde cero, con capturas de pantalla y ejemplos prácticos, ideal para quienes aprenden mejor con papel.
Podemos recibir una pequeña comisión — sin costo adicional para ti.
2
Sube tu primer proyecto desde la web
Aprende a cargar archivos directamente desde el navegador.
-
1
Abre tu repositorio en GitHub — Ve a github.com/tu-usuario/mi-primer-proyecto.
-
2
Haz clic en 'Add file' y luego 'Upload files' — Se abrirá una ventana para arrastrar archivos.
-
3
Arrastra tus archivos de proyecto — Por ejemplo, un index.html, styles.css y app.js. Si tienes una carpeta, compríme la en ZIP y súbela, luego extráela desde la web (no es necesario, puedes subir archivo por archivo).
-
4
Escribe un mensaje de commit — En el cuadro de texto, escribe algo como 'Primera subida de mi proyecto web'. El commit es como una foto de cómo están tus archivos en ese momento.
-
5
Haz clic en 'Commit changes' — Listo. Tus archivos ya están en GitHub. Puedes verlos en la pestaña Code.
Nunca subas archivos con contraseñas o API keys. Si lo haces por error, GitHub los detecta y te avisa. Mejor usa un archivo .gitignore (GitHub te ofrece plantillas al crear el repo).
3
Clona un repositorio a tu PC con GitHub Desktop
Descarga un proyecto a tu computadora para trabajar localmente usando una interfaz gráfica.
-
1
Descarga e instala GitHub Desktop — Ve a desktop.github.com y descarga la versión para tu sistema operativo. Instálalo como cualquier programa.
-
2
Inicia sesión con tu cuenta de GitHub — Abre GitHub Desktop y haz clic en 'Sign in to GitHub.com'. Se abrirá tu navegador para autorizar la app.
-
3
Clona un repositorio existente — Haz clic en 'File' > 'Clone repository'. Selecciona tu repositorio 'mi-primer-proyecto' de la lista. Elige una carpeta en tu PC donde guardarlo (ej: C:\Proyectos). Haz clic en 'Clone'.
-
4
Trabaja en los archivos localmente — Abre la carpeta con tu editor de código (VS Code, Sublime, etc.). Haz cambios, por ejemplo, modifica el README.
-
5
Sube los cambios a GitHub — En GitHub Desktop, verás los archivos modificados. Escribe un mensaje de commit (ej: 'Actualicé el README'), haz clic en 'Commit to main' y luego en 'Push origin' para subir los cambios a GitHub.
Si trabajas en equipo, antes de hacer push, haz clic en 'Fetch origin' para traer los cambios de otros y evitar conflictos.
4
Colabora con otros usando Pull Requests
Aprende a proponer cambios en proyectos de otras personas o recibir sugerencias en los tuyos.
-
1
Haz un fork de un repositorio — Ve a un proyecto público que te interese (ej: el de un amigo) y haz clic en 'Fork' (arriba a la derecha). Esto crea una copia del proyecto en tu cuenta.
-
2
Clona tu fork a tu PC — Usa GitHub Desktop para clonar tu fork (no el original). Haz cambios en los archivos, por ejemplo, corrige un error.
-
3
Sube los cambios a tu fork — Haz commit y push como antes. Tus cambios ahora están en tu copia del proyecto.
-
4
Crea un Pull Request — En GitHub, ve a tu fork y haz clic en 'Pull request' (al lado de 'Code'). Asegúrate de que la base sea el repositorio original y la comparación tu fork. Escribe un título y descripción de tus cambios.
-
5
Espera la revisión — El dueño del proyecto original verá tu PR y podrá comentar, pedir cambios o aceptarlo. Si lo acepta, tus cambios se fusionarán (merge) con el proyecto original.
Cuando hagas un PR, explica claramente qué cambiaste y por qué. Incluye capturas de pantalla si es un cambio visual. Los mantenedores lo agradecen.
Producto Recomendado
GitHub Desktop
Por qué ayuda: Es la herramienta oficial de GitHub para gestionar repositorios sin usar la línea de comandos, perfecta para principiantes.
Podemos recibir una pequeña comisión — sin costo adicional para ti.
5
Domina los comandos básicos de Git en terminal
Aprende los 5 comandos esenciales de Git para manejar proyectos desde la línea de comandos.
-
1
Instala Git en tu PC — Descarga e instala Git desde git-scm.com. En Windows, elige 'Git Bash' como terminal. En Mac/Linux, usa la terminal nativa.
-
2
Configura tu identidad — Abre la terminal y escribe: git config --global user.name "Tu Nombre" y git config --global user.email "tu@email.com".
-
3
Inicializa un repositorio local — Crea una carpeta para tu proyecto (ej: mkdir mi-proyecto, cd mi-proyecto). Ejecuta git init. Esto crea una carpeta oculta .git.
-
4
Añade archivos al área de staging — Crea un archivo (ej: echo "# Mi proyecto" > README.md). Luego escribe git add README.md (o git add . para añadir todo).
-
5
Haz tu primer commit — Ejecuta git commit -m "Primer commit: README". Ahora tu cambio está guardado localmente.
-
6
Conecta con un repositorio remoto — Crea un repositorio vacío en GitHub (sin README). Copia la URL (ej: https://github.com/tu-usuario/mi-proyecto.git). En terminal: git remote add origin esa-url.
-
7
Sube tus cambios — Ejecuta git push -u origin main. Si tu rama se llama master, usa master. Ingresa tu usuario y contraseña (o token). Tus archivos están en GitHub.
Si te pide contraseña y tienes autenticación de dos factores, necesitas un token personal: ve a Settings > Developer settings > Personal access tokens > Generate new token. Marca 'repo' y copia el token. Úsalo como contraseña.
⚠️ Cuándo buscar ayuda profesional
Si llevas una semana intentando entender conceptos como rebase, conflictos de merge o hooks y todavía te sientes perdido, no está mal pedir ayuda. A veces un compañero de trabajo o un amigo te lo explica en 5 minutos. También puedes buscar en Stack Overflow o en la comunidad de GitHub Discussions. Pero si lo que quieres es trabajar en equipo y necesitas dominar flujos complejos, considera un curso estructurado (como los de Platzi o Udemy) o leer la documentación oficial de Git.
GitHub no es tan complicado como parece. La clave está en empezar con lo básico: crear un repositorio, subir archivos y hacer commits. Con el tiempo, irás aprendiendo más comandos y flujos de trabajo. No te obsesiones con entenderlo todo de golpe. Yo mismo todavía busco comandos en Google cada semana. Lo importante es que empieces a usar GitHub aunque sea para guardar tus proyectos personales. Con la práctica, se vuelve natural. Y cuando menos lo esperes, estarás haciendo pull requests y colaborando con otros sin pensar dos veces.
❓ Preguntas Frecuentes
¿GitHub es gratis?
Sí, GitHub es gratis para usuarios individuales. Los repositorios públicos son gratuitos, y también los privados con hasta 3 colaboradores. Si necesitas más, hay planes de pago.
¿Necesito saber programar para usar GitHub?
No, GitHub se usa para cualquier tipo de archivo: documentos, diseños, libros, etc. Aunque es más común en programación, puedes usarlo para control de versiones de cualquier proyecto.
¿Cuál es la diferencia entre Git y GitHub?
Git es el sistema de control de versiones que se instala en tu computadora. GitHub es un servicio en la nube que aloja repositorios Git y añade funciones sociales como pull requests.
¿Qué es un commit?
Un commit es una instantánea de tus archivos en un momento dado. Cada commit tiene un mensaje que describe los cambios. Sirve para llevar un historial y poder volver atrás si algo falla.
¿Cómo subo un proyecto grande a GitHub?
Si tu proyecto tiene más de 100 MB, considera usar Git LFS (Large File Storage) o subir archivos por partes. GitHub tiene un límite de 100 MB por archivo, pero puedes subir hasta 2 GB por repositorio.
💬 Comparte tu Experiencia
¡Comparte tu experiencia — ayuda a otros con el mismo reto!