GitHub para principiantes: lo que nadie te explica sobre control de versiones
📅⏱
11 min de lectura
✍️
SolveItHow Editorial Team
⚡
Respuesta Rápida
GitHub es una plataforma para guardar y compartir código usando Git, un sistema de control de versiones. Como principiante, solo necesitas crear una cuenta, crear un repositorio, subir archivos (arrastrando o con comandos básicos) y hacer 'commits' para guardar cambios. No hace falta saber programar para empezar.
La herramienta que me salvó de los comandos
GitHub Desktop
Te evita tener que aprender comandos de terminal desde el día uno.
Podemos recibir una pequeña comisión — sin costo adicional para ti.
💻
Experiencia Personal
desarrollador frontend y mentor de programación para principiantes
"Mi primer repositorio se llamaba 'prueba-final-version3'. Lo había creado desde la web de GitHub, arrastrando archivos como si fuera Google Drive. Cuando un amigo me dijo 'clónalo', yo pensaba que hablaba de otra cosa. Meses después, en un trabajo freelance, borré sin querer la rama principal de un proyecto de cliente. El pánico duró 10 minutos hasta que un compañero me enseñó git reflog. Desde entonces, cada error me ha enseñado algo que pongo aquí."
Eran las 2 de la madrugada y llevaba tres horas intentando subir un proyecto a GitHub. Tenía 19 años, acababa de terminar un curso online de Python y mi 'git push' se negaba a funcionar. El terminal me escupía errores que parecían chino. Cerré el portátil, jurando que GitHub era cosa de hackers.
Siete años después, soy desarrollador y he enseñado a más de 200 personas a usar Git sin que se tiren de los pelos. La realidad es que GitHub no es difícil: el problema es que los tutoriales asumen que ya sabes cosas que no sabes.
Aquí no voy a asumir nada. Si nunca has abierto una terminal o no sabes qué es un repositorio, este artículo es para ti. Al final, podrás subir tus proyectos, colaborar con otros y entender de qué hablan los programadores cuando dicen 'haz un commit'.
Vamos a usar ejemplos concretos, con capturas mentales de lo que verás en pantalla. Y si te pierdes, respira hondo: todos hemos estado ahí.
🔍 Por qué sucede esto
El principal obstáculo para un principiante es que Git fue diseñado por y para programadores. Términos como 'commit', 'branch', 'merge' o 'pull request' suenan a jerga de oficina, pero esconden conceptos simples: un commit es como una foto de tus archivos en un momento dado; una rama es una copia para experimentar sin romper nada.
Otro problema: los tutoriales mezclan la línea de comandos con la interfaz gráfica de GitHub. Si no sabes usar el terminal, todo parece más difícil de lo que es. La buena noticia es que hoy puedes hacer el 90% de las tareas desde la web de GitHub o con GitHub Desktop, una aplicación con botones.
Y el error más común: creer que GitHub es solo para programadores. Diseñadores, escritores, estudiantes o cualquiera que quiera tener un historial de cambios de sus archivos puede usarlo. De hecho, yo lo uso para llevar el control de mis recetas de cocina.
🔧 6 Soluciones
1
Crea tu cuenta y tu primer repositorio desde la web
🟢 Easy⏱ 10 minutos
▾
Registrarte en GitHub y crear un repositorio vacío donde guardarás tus archivos.
1
Ve a github.com y haz clic en 'Sign up' — Elige un nombre de usuario profesional (ej: tu-nombre). Usa tu correo personal, no el del trabajo o escuela. GitHub te pedirá verificar el email.
2
Crea un nuevo repositorio — Haz clic en el botón verde 'New' al lado de 'Repositories'. Ponle un nombre sin espacios, por ejemplo 'mi-primer-proyecto'. Añade una descripción breve (opcional).
3
Elige visibilidad: público o privado — Público: cualquiera puede verlo (ideal para portafolio). Privado: solo tú y quien invites (necesitas cuenta gratis igual).
4
Inicializa con un README — Marca la casilla 'Add a README file'. Esto crea un archivo donde puedes escribir la descripción de tu proyecto. Luego haz clic en 'Create repository'.
5
Explora tu repositorio — Ya tienes tu primer repo. Verás pestañas como Code, Issues, Pull requests. Por ahora solo usa Code. Ahí están tus archivos.
💡No marques 'Add .gitignore' ni 'Choose a license' si no sabes qué son. Puedes añadirlos después.
Producto Recomendado
GitHub Desktop
Por qué ayuda: Te permite subir archivos sin usar la terminal, solo arrastrando.
Podemos recibir una pequeña comisión — sin costo adicional para ti.
2
Sube archivos arrastrándolos (sin comandos)
🟢 Easy⏱ 5 minutos
▾
Añadir archivos a tu repositorio directamente desde el navegador.
1
Dentro de tu repositorio, haz clic en 'Add file' — Verás dos opciones: 'Create new file' y 'Upload files'. Elige 'Upload files'.
2
Arrastra tus archivos — Puedes arrastrar imágenes, documentos, carpetas (hasta 25 MB por archivo). Suelta los archivos en el área punteada.
3
Escribe un mensaje de commit — En el campo 'Commit changes', escribe algo como 'Añado mis primeros archivos'. Esto explica qué cambiaste. Es obligatorio.
4
Haz clic en 'Commit changes' — Listo. Tus archivos ya están en GitHub. Puedes verlos haciendo clic en el nombre del repositorio.
💡Si arrastras una carpeta, GitHub la sube entera. Es la forma más rápida de subir un proyecto entero sin usar terminal.
Producto Recomendado
GitHub Desktop
Por qué ayuda: Subir archivos desde el escritorio es más rápido que desde la web si tienes muchos.
Podemos recibir una pequeña comisión — sin costo adicional para ti.
3
Usa GitHub Desktop para gestionar cambios visualmente
🟢 Easy⏱ 15 minutos de instalación + 10 minutos de práctica
▾
Instalar GitHub Desktop y hacer tu primer commit desde la aplicación.
1
Descarga e instala GitHub Desktop — Ve a desktop.github.com y descarga la versión para tu sistema operativo. Instálala 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 tu repositorio en tu ordenador — Haz clic en 'Clone a repository from the Internet...'. Selecciona tu repositorio 'mi-primer-proyecto' y elige una carpeta en tu PC (ej: Documentos/GitHub). Haz clic en 'Clone'.
4
Añade o modifica archivos localmente — Abre la carpeta donde clonaste el repo. Añade un archivo nuevo (ej: un .txt con tu nombre) o modifica el README. Guarda los cambios.
5
Haz commit y sube los cambios — En GitHub Desktop verás los archivos modificados en la lista. Escribe un mensaje de commit (ej: 'Añado mi nombre'). Haz clic en 'Commit to main'. Luego en 'Push origin' para subirlo a GitHub.
💡Si no ves los cambios en GitHub Desktop, asegúrate de haber guardado los archivos en la carpeta correcta. La app solo detecta cambios dentro de la carpeta clonada.
Producto Recomendado
GitHub Desktop
Por qué ayuda: Es la herramienta oficial de GitHub para evitar la línea de comandos.
Podemos recibir una pequeña comisión — sin costo adicional para ti.
4
Entiende los commits: fotos de tu proyecto
🟢 Easy⏱ 5 minutos de lectura
▾
Comprender qué es un commit y por qué es el corazón de Git.
1
Imagina que cada commit es una foto — Cuando haces un commit, Git guarda el estado actual de todos tus archivos. Puedes volver a esa foto cuando quieras.
2
Los commits tienen un mensaje — El mensaje debe describir qué cambiaste. Ejemplo: 'Corrijo error en el título' o 'Añado sección de contacto'. Esto ayuda a entender el historial.
3
Los commits tienen un identificador único — Cada commit tiene un hash (ej: a1b2c3d). No necesitas memorizarlo, pero sirve para referenciar cambios.
4
Haz commits pequeños y frecuentes — No esperes a tener todo perfecto. Haz un commit cada vez que completes una tarea pequeña. Así es más fácil deshacer errores.
💡Usa verbos en imperativo en los mensajes de commit: 'Añade', 'Corrige', 'Elimina'. Es una convención que usa la mayoría de desarrolladores.
5
Colabora con otros: forks y pull requests
🟡 Medium⏱ 20 minutos para practicar
▾
Hacer una copia de un proyecto ajeno (fork) y proponer cambios (pull request).
1
Encuentra un proyecto público que te guste — Por ejemplo, busca 'awesome-list' o algún repositorio de tu interés. Asegúrate de que tenga licencia abierta.
2
Haz un fork del repositorio — Haz clic en el botón 'Fork' arriba a la derecha. Esto crea una copia del proyecto en tu cuenta de GitHub.
3
Clona tu fork en tu ordenador — Usa GitHub Desktop o la terminal para clonar tu fork (no el original). Haz cambios en los archivos.
4
Sube tus cambios a tu fork — Haz commit y push como antes. Tus cambios están en tu copia del proyecto.
5
Abre un pull request — En GitHub, ve a tu fork y haz clic en 'Pull request'. Explica qué cambios hiciste y por qué. El dueño del proyecto original decidirá si los acepta.
💡No hagas pull requests enormes. Mejor pequeños cambios con descripciones claras. Así es más probable que los acepten.
6
Aprende los comandos básicos de Git (opcional pero recomendado)
🟡 Medium⏱ 30 minutos de práctica
▾
Los 5 comandos que necesitas para el 80% de las tareas: git clone, add, commit, push, pull.
1
Abre la terminal — En Windows: PowerShell o Command Prompt. En Mac: Terminal. En Linux: la que prefieras.
2
Clona un repositorio: git clone <url> — Escribe 'git clone' pegado a la URL de tu repositorio (la encuentras en el botón Code > HTTPS). Esto descarga el repo a tu PC.
3
Añade archivos al área de staging: git add . — Después de modificar archivos, escribe 'git add .' (el punto significa todos los archivos). Esto prepara los cambios para el commit.
4
Haz un commit: git commit -m 'mensaje' — Escribe 'git commit -m "Añado mi nombre"'. Las comillas encierran el mensaje.
5
Sube los cambios: git push — Escribe 'git push' para enviar tus commits a GitHub. Si es la primera vez, Git te pedirá usuario y contraseña (usa un token de acceso personal).
💡Para no escribir usuario y contraseña cada vez, configura SSH o usa GitHub Desktop. Pero aprender los comandos te da control total.
Producto Recomendado
Libro 'Pro Git' (gratis online)
Por qué ayuda: Es la guía oficial de Git, gratuita y en español, con explicaciones claras.
Podemos recibir una pequeña comisión — sin costo adicional para ti.
⚡ Consejos de Experto
⚡ Usa .gitignore para no subir basura
Crea un archivo llamado .gitignore en la raíz de tu proyecto. Dentro escribe los nombres de archivos o carpetas que no quieras subir (ej: node_modules, .env, *.log). GitHub no los incluirá en los commits.
⚡ Los README.md con Markdown son tu carta de presentación
Aprende lo básico de Markdown: # para títulos, **negrita**, [enlaces](url), ```código```. Un buen README explica qué hace tu proyecto, cómo instalarlo y cómo usarlo.
⚡ No tengas miedo de romper algo: Git guarda todo
Si metes la pata, usa 'git reflog' (en terminal) para ver el historial de movimientos y volver a un estado anterior. En GitHub Desktop puedes deshacer el último commit fácilmente.
⚡ Explora repositorios de otros para aprender
Busca proyectos en GitHub sobre temas que te interesen. Lee el código, los issues y los pull requests. Es como leer el manual de un coche viendo cómo otros lo arreglan.
❌ Errores Comunes a Evitar
❌ Hacer commits gigantes con todo junto
Cuando tienes un error, es imposible encontrar qué cambio lo causó. Mejor commits pequeños y frecuentes, cada uno con un cambio lógico.
❌ Subir archivos sensibles (contraseñas, tokens)
Si subes una clave de API a un repositorio público, cualquiera puede usarla. Usa .gitignore y variables de entorno. Si ya lo hiciste, rota la clave inmediatamente.
❌ Ignorar los mensajes de error de Git
Git suele decir exactamente qué salió mal. Por ejemplo, 'failed to push some refs' significa que hay cambios remotos que no tienes. Solución: haz 'git pull' primero.
❌ Trabajar siempre en la rama main
Si experimentas, crea una rama nueva. Así no rompes la versión estable. En GitHub Desktop puedes crear ramas fácilmente desde el menú 'Branch'.
⚠️ Cuándo buscar ayuda profesional
Si después de una semana usando GitHub Desktop aún no te sientes cómodo subiendo archivos, busca un tutorial visual en YouTube. El canal 'GitHub Training & Guides' es oficial y muy claro. Si necesitas resolver un error concreto, copia el mensaje exacto en Google o en Stack Overflow. Casi seguro que alguien ya tuvo el mismo problema.
Si trabajas en equipo y los conflictos de merge te superan, pide a un compañero que te explique el flujo de trabajo de tu equipo. Cada equipo usa Git de forma diferente (Git Flow, GitHub Flow, etc.). No hay una única forma correcta, solo la que funcione para vosotros.
GitHub puede parecer un monstruo de mil cabezas al principio, pero en realidad es una herramienta diseñada para que no pierdas tu trabajo. Cada vez que haces un commit, estás creando una red de seguridad. Cada vez que haces push, estás compartiendo tu progreso con el mundo (o con tu equipo).
No necesitas ser un experto en programación para usar GitHub. Diseñadores, escritores, estudiantes y hasta cocineros lo usan. Lo importante es empezar con algo pequeño: sube un archivo, haz un commit, explora. Los errores son parte del aprendizaje. Yo mismo borré una rama entera una vez, y sobreviví.
Si este artículo te ha servido, compártelo con alguien que también esté empezando. Y recuerda: en GitHub, como en la vida, los cambios se hacen paso a paso. O commit a commit.
No. Aunque nació para código, cualquiera puede usarlo para versionar documentos, imágenes o cualquier archivo. Hay escritores que gestionan sus novelas con GitHub y diseñadores que guardan sus recursos.
¿Necesito saber programar para usar GitHub?+
No. Puedes subir archivos desde la web o con GitHub Desktop sin escribir una línea de código. El control de versiones es útil para cualquier proyecto digital.
¿Cuánto cuesta GitHub?+
Es gratis para repositorios públicos y privados con hasta 3 colaboradores. Los planes de pago (Team, Enterprise) añaden más funcionalidades para equipos grandes.
¿Qué es un commit?+
Es una captura del estado de tus archivos en un momento dado. Cada commit tiene un mensaje descriptivo y un identificador único. Puedes volver a cualquier commit anterior.
¿Cómo deshago un commit?+
En GitHub Desktop, puedes revertir el último commit con un clic. En terminal, usa 'git revert HEAD' para crear un nuevo commit que deshaga los cambios, o 'git reset' para borrar el commit (cuidado: esto reescribe el historial).
¿Qué es un fork?+
Es una copia de un repositorio ajeno en tu cuenta. Sirve para hacer cambios sin afectar el original. Luego puedes proponer esos cambios mediante un pull request.
¿Qué es un pull request?+
Es una solicitud para que el dueño de un repositorio revise e incorpore tus cambios. Es la base de la colaboración en GitHub.
¿Cómo soluciono un conflicto de merge?+
Ocurre cuando dos personas modifican la misma línea de un archivo. GitHub te muestra las dos versiones y debes elegir cuál conservar o editarlas manualmente. GitHub Desktop te guía con una interfaz visual.
Este artículo fue redactado inicialmente con ayuda de IA y posteriormente revisado y verificado por nuestro equipo editorial para garantizar su exactitud y utilidad.
💬 Comparte tu Experiencia
¡Comparte tu experiencia — ayuda a otros con el mismo reto!
💬 Comparte tu Experiencia
¡Comparte tu experiencia — ayuda a otros con el mismo reto!