Guía Práctica: Primeros Pasos con Git y GitHub
Si trabajas o piensas trabajar con Salesforce — especialmente del lado de desarrollo — te vas a topar con Git y GitHub más temprano que tarde. En realidad, probablemente más temprano. Es una de esas habilidades que nadie te enseña en la universidad, pero que todo tech lead espera que sepas desde el primer día.
La buena noticia: Git no es tan complicado como parece. En esta guía, te voy a llevar de cero a tu primer repositorio en GitHub, paso a paso. Sin misterio, sin jerga innecesaria.
Qué es Git (y por qué lo necesitas)
Git es un sistema de control de versiones. En la práctica, rastrea todos los cambios que haces en tus archivos y te permite volver a cualquier versión anterior. Piénsalo como un "Ctrl+Z infinito e inteligente" para tu código.
GitHub es una plataforma en línea que aloja repositorios Git. Es donde los equipos colaboran, revisan código y mantienen proyectos organizados. Si Git es el motor, GitHub es el garaje en la nube.
Toda empresa seria que trabaja con Salesforce usa Git. Si quieres destacarte en el mercado, dominar estas herramientas no es opcional — es prerrequisito.
Instalando Git en tu computadora
El proceso es sencillo y toma menos de 5 minutos, sin importar tu sistema operativo.
Windows:
Descarga el instalador en git-scm.com. En la instalación, acepta las opciones por defecto. Incluye Git Bash, una terminal propia que emula comandos Linux en Windows — es lo que vamos a usar en este tutorial.
macOS:
Abre la Terminal (busca "Terminal" en Spotlight con Cmd+Espacio) y escribe:
git --version
Si Git no está instalado, el sistema te ofrecerá instalarlo automáticamente. También puedes instalarlo vía Homebrew:
brew install git
Linux (Ubuntu/Debian):
sudo apt update && sudo apt install git
Para Fedora: sudo dnf install git.
Verificando la instalación:
Después de instalar, abre la terminal y confirma:
git --version
Si aparece algo como git version 2.43.0 (cualquier versión 2+), todo está bien.
Tip: si el comando git no es reconocido en Windows, reinicia la terminal o la computadora. La instalación puede necesitar que la terminal se vuelva a abrir.
Configuración inicial: tu identidad
Antes de usar Git, necesitas configurar tu nombre y correo electrónico. Esta información aparece en cada commit que hagas — es tu firma digital.
git config --global user.name "Tu Nombre"
git config --global user.email "tu@email.com"
Para confirmar que funcionó:
git config user.name
git config user.email
El --global significa que estas configuraciones aplican para todos los repositorios de tu computadora. Solo necesitas hacerlo una vez.
Importante: usa el mismo correo que vas a registrar en GitHub. Esto garantiza que tus commits se vinculen a tu perfil. Si los correos son diferentes, tus contribuciones aparecen como de un usuario desconocido.
Opcional, pero recomendado — definir VS Code como editor por defecto:
git config --global core.editor "code --wait"
Conociendo la terminal: comandos básicos
Mucha gente le tiene miedo a la terminal — esa pantalla negra con letras. Pero es más sencillo de lo que parece. Para trabajar con Git, solo necesitas 5 comandos de navegación:
| Comando | Qué hace | Ejemplo |
|---|---|---|
pwd | Muestra en qué carpeta estás | pwd → /Users/tu/proyectos |
ls | Lista archivos de la carpeta actual | ls → carpeta1 carpeta2 archivo.txt |
cd carpeta | Entra a una carpeta | cd proyectos → entra a la carpeta |
cd .. | Regresa una carpeta arriba | cd .. → sube un nivel |
mkdir nombre | Crea una carpeta nueva | mkdir mi-proyecto → crea la carpeta |
Tip: la tecla Tab autocompleta nombres de carpetas y archivos en la terminal. Empieza a escribir y presiona Tab. Esto evita errores de escritura y acelera todo.
En Windows, si estás usando Git Bash (recomendado), estos mismos comandos funcionan normalmente. Fuera de Git Bash, los equivalentes son diferentes (dir en lugar de ls, por ejemplo), así que usa Git Bash para seguir este tutorial.
Creando tu primer repositorio
Ahora viene la parte buena. Vamos a crear un repositorio Git desde cero, directo en la terminal.
Paso 1 — Crea una carpeta para el proyecto y entra a ella:
mkdir mi-primer-repo
cd mi-primer-repo
Paso 2 — Inicializa el repositorio Git:
git init
Este comando crea una subcarpeta oculta llamada .git dentro de tu proyecto. Ahí es donde Git guarda todo el historial. A partir de ahora, esta carpeta es un repositorio Git — cada cambio puede ser rastreado.
Paso 3 — Crea un archivo:
echo "# Mi Primer Proyecto" > README.md
Paso 4 — Verifica el estado del repositorio:
git status
Vas a ver que README.md aparece como "untracked" (en rojo). Esto significa que Git sabe que el archivo existe, pero aún no lo está rastreando.
Tu primer commit
Aquí sucede la magia. El flujo básico de Git sigue tres etapas: editar → git add (preparar) → git commit (guardar en el historial).
Paso 5 — Agrega el archivo al staging:
git add README.md
El staging area (área de preparación) es donde seleccionas qué cambios quieres incluir en el próximo commit. No todo lo que modificaste tiene que entrar en el mismo commit — y eso es una de las grandes ventajas de Git.
Paso 6 — Haz el commit:
git commit -m "Primer commit: agrega README"
Listo. Acabas de guardar la primera versión de tu proyecto en el historial de Git. El -m te permite escribir el mensaje del commit directamente en la línea de comandos.
Buenas prácticas para mensajes de commit: usa verbos en imperativo y sé descriptivo. "Agrega validación de email" es mucho mejor que "cambios varios". Si alguien lee solo el mensaje, debería entender lo que se hizo sin necesidad de ver el código.
Para ver el historial de tus commits:
git log --oneline
Tip: para salir de la pantalla de git log, presiona la tecla q. Mucha gente se queda atrapada en esa pantalla al principio.
Conectando a GitHub
Hasta ahora, todo está en tu computadora (local). Para subir tu proyecto a GitHub, sigue estos pasos:
1. Crea una cuenta en GitHub en github.com (si aún no tienes una).
2. Crea un nuevo repositorio haciendo clic en "New repository". Ponle el mismo nombre de tu carpeta (mi-primer-repo). No marques ninguna opción de inicialización (sin README, sin .gitignore).
3. Conecta tu repositorio local a GitHub:
git remote add origin https://github.com/tu-usuario/mi-primer-repo.git
4. Envía tu código a GitHub:
git push -u origin main
El -u origin main configura el tracking, es decir, le dice a Git que la branch main local corresponde a la branch main en GitHub. Solo necesitas usar -u en el primer push. En los siguientes, basta con git push.
Actualiza la página de GitHub y vas a ver tu archivo ahí. Felicidades — tu código está en la nube.
El flujo del día a día: add, commit, push
Una vez que el repositorio está configurado, tu rutina con Git se resume a:
# 1. Haz tus cambios en los archivos
# 2. Revisa qué cambió
git status
# 3. Agrega los cambios al staging
git add archivo-modificado.txt
# 4. Haz el commit
git commit -m "Describe lo que se hizo"
# 5. Envía a GitHub
git push
Y cuando estés trabajando en equipo, empieza siempre el día con:
git pull
Esto descarga los cambios que otros miembros enviaron a GitHub. Siempre haz git pull antes de git push — si alguien envió commits que tú no tienes, el push será rechazado.
Regla de oro: ¿Llegas a trabajar? git pull. ¿Vas a terminar el día? git push. Commits pequeños y frecuentes a lo largo del día. Así de simple.
FAQ
¿Cuál es la diferencia entre Git y GitHub?
Git es la herramienta de control de versiones que corre en tu computadora. GitHub es una plataforma en línea que aloja repositorios Git y ofrece funcionalidades de colaboración (Pull Requests, Issues, etc). Puedes usar Git sin GitHub, pero no GitHub sin Git.
¿Necesito saber usar la terminal para usar Git?
Técnicamente, existen interfaces gráficas (como GitHub Desktop y el panel de VS Code). Pero aprender los comandos básicos en la terminal te da más control y es lo que la mayoría de los equipos profesionales usa. Los 5 comandos de navegación que mostré aquí son todo lo que necesitas para empezar.
¿Qué es un commit, en la práctica?
Un commit es como tomar una "foto" del estado actual de tus archivos. Registra exactamente qué cambió, cuándo, y quién hizo el cambio. Puedes volver a cualquier commit anterior si lo necesitas. Piénsalo como un punto de guardado en un videojuego.
Me equivoqué en un commit. ¿Cómo lo deshago?
Si quieres deshacer el último commit pero mantener los cambios en los archivos, usa:
git reset --soft HEAD~1
Esto elimina el commit del historial pero mantiene tus archivos intactos. Puedes corregir y hacer commit de nuevo.
Si quieres ir más allá de este tutorial y dominar Git y GitHub de verdad — con ejercicios prácticos, quizzes y proyectos guiados — dale un vistazo al curso Git y GitHub Esencial en la Rangers League Academy, disponible en /es/academy. Ahí vas a aprender desde los fundamentos hasta flujos avanzados como branching, merge, resolución de conflictos y Pull Requests. Todo al ritmo ideal para quien está empezando.
