Inicio

Introducción al Control de Versiones

Está trabajando en un proyecto y realiza cambios que rompen todo. No recuerda qué cambió y desea volver a cuando todo funcionaba. El control de versiones es como los puntos de guardado en un videojuego: cada vez que hace “commit” de su trabajo, crea un punto de restauración al que siempre puede volver. GitHub almacena sus puntos de guardado en la nube, así su código está respaldado de forma segura y accesible desde cualquier computadora.

Conceptos Clave

• Git - Software de control de versiones que rastrea los cambios de sus archivos en su computadora
• GitHub - Sitio web que almacena su código en la nube, como Google Drive pero para código
• GitHub Desktop - Aplicación que facilita el uso de Git mediante botones en lugar de comandos
• Repository (repo) - Carpeta de proyecto que rastrea todos sus cambios

Lo Que Necesitará

• Una computadora con Windows o Mac (GitHub Desktop no funciona en Linux)
• Conexión a Internet
• Dirección de correo electrónico para cuenta de GitHub
• 15-20 minutos

Paso 1: Crear una Cuenta de GitHub

• Abra su navegador web
• Vaya a github.com
• Haga clic en Sign up
• Ingrese su correo electrónico, cree una contraseña y elija un nombre de usuario
• Complete los pasos de verificación

Paso 2: Descargar GitHub Desktop

• Vaya a desktop.github.com
• Haga clic en el botón Download
• Abra el archivo descargado para instalar

En Windows:

• Haga doble clic en el archivo del instalador
• GitHub Desktop se instala y se abre automáticamente

En Mac:

• Abra el archivo .zip descargado
• Arrastre GitHub Desktop a su carpeta Aplicaciones (Applications)
• Abra GitHub Desktop desde Aplicaciones

Paso 3: Iniciar Sesión en GitHub Desktop

• Abra GitHub Desktop
• Haga clic en Sign in to GitHub.com
• Su navegador se abre—inicie sesión si se le pide y luego haga clic en Authorize desktop
• Si su navegador le pregunta si desea abrir GitHub Desktop, haga clic en Open (o Allow)
• Vuelva a GitHub Desktop
• Haga clic en Finish para completar la configuración

Paso 4: Crear Su Primer Repositorio

• En GitHub Desktop, haga clic en Create a New Repository on your Local Drive
• Complete el formulario:
  • Name: mi-primer-proyecto (o cualquier nombre que desee)
  • Description: Aprendiendo control de versiones (opcional)
  • Local Path: Elija dónde guardarlo (la carpeta Documentos está bien)
  • Marque Initialize this repository with a README
• Haga clic en Create Repository

Paso 5: Abrir la Carpeta de Su Proyecto

• En GitHub Desktop, haga clic en Repository en la barra de menú
• Seleccione Show in Finder (Mac) o Show in Explorer (Windows)
• Verá una carpeta con el nombre de su proyecto
• Dentro hay un archivo llamado README.md

Paso 6: Realizar Su Primer Cambio

• Abra README.md en cualquier editor de texto (Notepad, TextEdit o VS Code)
• Reemplace el contenido con:

  # Mi Primer Proyecto
  
  Estoy aprendiendo control de versiones con GitHub Desktop.
  
  ## Qué Estoy Construyendo
  
  Este es un proyecto de práctica para aprender a:
  - Rastrear cambios en mi código
  - Crear puntos de guardado (commits)
  - Respaldar mi trabajo en GitHub
  

• Haga clic en File → Save

Paso 7: Crear Su Primer Commit (Punto de Guardado)

• Vuelva a GitHub Desktop
• Verá sus cambios resaltados en el lado derecho (verde = agregado, rojo = eliminado)
• En la parte inferior izquierda, escriba un mensaje de commit: Actualizar README con descripción del proyecto
• Haga clic en el botón azul Commit 1 file to main (el número coincide con la cantidad de archivos que cambió)

Paso 8: Enviar a GitHub (Respaldar en la Nube)

• Haga clic en el botón azul Publish repository en la parte superior
• Mantenga el nombre tal como está
• Desmarque “Keep this code private” si desea que otros lo vean (opcional)
• Haga clic en Publish Repository

Su código ahora está respaldado en línea en: https://github.com/SU-USUARIO/mi-primer-proyecto

Próximos Pasos

• Edite su archivo README nuevamente y haga commit de los cambios
• Cree un nuevo archivo en la carpeta de su proyecto y haga commit de él
• Explore la pestaña History para ver cómo evoluciona su proyecto con el tiempo

Solución de Problemas

• No puede iniciar sesión en GitHub - Verifique su conexión a Internet. Intente iniciar sesión primero en github.com para confirmar que sus credenciales funcionen.
• Los cambios no aparecen en GitHub Desktop - Asegúrese de haber guardado sus archivos. Haga clic en otra aplicación y luego de vuelta en GitHub Desktop, o reinicie GitHub Desktop.
• El envío falla con error “rejected” - Alguien más envió cambios. Haga clic en Fetch origin, luego en Pull origin y después haga clic en Push origin de nuevo.

Descripción General del Flujo de Trabajo

• Realice cambios en los archivos de su proyecto
• Revise los cambios en GitHub Desktop (verde = agregado, rojo = eliminado)
• Escriba un mensaje de commit descriptivo y haga clic en el botón azul de commit en la parte inferior (dice algo como Commit 1 file to main)
• Haga clic en Push origin para respaldar en GitHub
• Repita

Creado por Steven Ge el 7 de diciembre de 2025.