Git Bash en Windows: instalación paso a paso y primeros comandos
En este artículo
Git Bash es la terminal que viene con Git para Windows. Te da una línea de comandos estilo Linux dentro de Windows, que es donde se ejecutan los comandos de Git tal y como aparecen en casi toda la documentación y los tutoriales.
Aquí tienes la instalación completa, qué marcar en cada pantalla del instalador (que es donde la gente se atasca) y los comandos que de verdad vas a usar la primera semana.
Qué es Git Bash y por qué lo necesitas
Conviene separar dos cosas que suelen confundirse:
Git es el sistema de control de versiones: el programa que guarda el historial de cambios de tu código, permite volver atrás y trabajar en paralelo con otras personas.
Git Bash es una terminal que se instala junto con Git en Windows. Emula el intérprete Bash de Linux, así que entiende comandos como ls, cd o touch además de los de Git.
¿Y por qué no usar el símbolo del sistema de Windows? Porque la mayoría de tutoriales, cursos y documentación están escritos con sintaxis Unix. Con Git Bash copias y pegas cualquier comando y funciona. Con CMD, la mitad no.
Descargar e instalar
Paso 1. Descarga el instalador
Entra en git-scm.com/download/win. La descarga suele empezar sola y detecta si tu Windows es de 64 bits, que es lo habitual.
Descárgalo siempre del sitio oficial. Hay páginas que redistribuyen instaladores de Git con software añadido.
Paso 2. Ejecuta el instalador
El asistente tiene bastantes pantallas y muchas dan igual. Estas son las que importan:
Select Components. Deja lo que viene marcado y añade "Add a Git Bash Profile to Windows Terminal" si lo ves. Te permite abrir Git Bash desde la Terminal de Windows.
Choosing the default editor. Por defecto propone Vim, y si no sabes usar Vim te vas a quedar atrapado en una pantalla sin saber cómo salir. Cambia a Visual Studio Code si lo tienes, o a Notepad. Este es el error número uno de quien instala Git por primera vez.
Adjusting the name of the initial branch. Elige "Override the default branch name" y escribe main. Es el nombre que usan hoy GitHub, GitLab y prácticamente todos los proyectos nuevos.
Adjusting your PATH environment. Deja la opción del medio, "Git from the command line and also from 3rd-party software". Es la recomendada y permite que otros programas encuentren Git.
Configuring the line ending conversions. Deja "Checkout Windows-style, commit Unix-style". Evita problemas de saltos de línea al colaborar con gente que usa Mac o Linux.
El resto de pantallas puedes dejarlas como vienen. Siguiente hasta terminar.
Paso 3. Comprueba que funciona
Abre el menú inicio, escribe "Git Bash" y ábrelo. Debería aparecer una ventana negra con el cursor. Escribe:
git --version
Si responde algo como git version 2.47.0.windows.1, está instalado correctamente.
Configuración inicial obligatoria
Antes de tu primer commit tienes que decirle a Git quién eres. Sin esto, Git se negará a guardar cambios.
git config --global user.name "Tu Nombre"
git config --global user.email "tucorreo@ejemplo.com"
Usa el mismo correo de tu cuenta de GitHub o GitLab, así tus commits se asocian a tu perfil.
Dos ajustes más que te van a ahorrar disgustos:
git config --global init.defaultBranch main
git config --global core.editor "code --wait"
El segundo solo si usas VS Code. Para comprobar toda tu configuración:
git config --list
Moverse por las carpetas
Git Bash usa comandos de Unix, no de Windows. Los que necesitas:
| Comando | Qué hace |
|---|---|
pwd | Muestra en qué carpeta estás |
ls | Lista los archivos |
ls -la | Los lista todos, incluidos los ocultos |
cd carpeta | Entra en una carpeta |
cd .. | Sube un nivel |
mkdir nombre | Crea una carpeta |
touch archivo.txt | Crea un archivo vacío |
clear | Limpia la pantalla |
Dos detalles propios de Windows que confunden al principio: las rutas se escriben con barra normal, y las unidades se montan con una barra delante. Tu disco C: es /c/, así que para ir a tus documentos sería:
cd /c/Users/TuUsuario/Documents
Atajo útil: abre el explorador de Windows en la carpeta que quieras, haz clic derecho y elige "Open Git Bash here". Se abre la terminal ya situada ahí.
Tus primeros comandos de Git
Crear un repositorio
mkdir mi-proyecto
cd mi-proyecto
git init
Eso crea una carpeta oculta .git donde vive todo el historial. No la toques a mano.
El ciclo básico de trabajo
Git tiene tres zonas y entenderlas evita el 90% de la confusión inicial:
- Directorio de trabajo: tus archivos tal como están ahora.
- Área de preparación (staging): los cambios que has seleccionado para guardar.
- Repositorio: el historial ya confirmado.
git status # ver qué ha cambiado
git add archivo.txt # preparar un archivo
git add . # preparar todo lo modificado
git commit -m "Descripción" # guardar en el historial
git log --oneline # ver el historial
Un commit no es un guardado automático: es una foto deliberada de un estado que consideras completo. Escribe mensajes que expliquen qué cambiaste y por qué, no "cambios" ni "update".
Conectar con GitHub
git remote add origin https://github.com/usuario/repositorio.git
git branch -M main
git push -u origin main
La primera vez se abrirá una ventana para autenticarte. Desde hace tiempo GitHub no acepta tu contraseña normal: necesitas un token de acceso personal, que se genera en Settings → Developer settings → Personal access tokens. Cópialo en cuanto lo generes, porque no se vuelve a mostrar.
Después del primer push -u, las siguientes veces basta con git push.
Ramas
git branch # ver las ramas
git checkout -b nueva-rama # crear una y cambiarse
git checkout main # volver a main
git merge nueva-rama # fusionar en la rama actual
Problemas frecuentes y cómo salir
"Estoy atrapado en una pantalla rara y no puedo escribir". Es Vim. Pulsa Esc, escribe :wq y pulsa Enter para guardar y salir. Para evitarlo siempre, cambia el editor con git config --global core.editor "notepad".
"Please tell me who you are". No configuraste nombre y correo. Ejecuta los dos comandos de git config del principio.
"Support for password authentication was removed". Estás intentando entrar con tu contraseña de GitHub. Necesitas un token de acceso personal.
"fatal: not a git repository". Estás en una carpeta que no es un repositorio. Comprueba dónde estás con pwd y entra en la carpeta correcta, o ejecuta git init.
El texto se ve cortado o se queda una barra al final. Estás dentro del paginador de git log. Pulsa q para salir.
"Your branch is ahead of origin/main by N commits". No es un error: tienes commits locales sin subir. Haz git push.
Atajos que agradecerás
- Tab autocompleta nombres de archivos y carpetas.
- Flecha arriba recupera comandos anteriores.
- Ctrl + Insert copia y Shift + Insert pega. El Ctrl+C normal no funciona aquí: interrumpe el proceso.
- Ctrl + L limpia la pantalla, igual que
clear. git log --oneline --graph --allmuestra el historial con las ramas dibujadas.
Preguntas frecuentes
¿Git Bash es lo mismo que Git?
No. Git es el programa; Git Bash es una de las terminales desde las que puedes usarlo en Windows.
¿Necesito Git Bash si uso Visual Studio Code?
No es obligatorio, porque VS Code integra Git. Pero saber los comandos te saca de problemas que la interfaz gráfica no resuelve bien, sobre todo con conflictos.
¿Funciona en Mac o Linux?
No hace falta: esos sistemas ya traen una terminal con Bash. Git Bash existe precisamente porque Windows no la tenía.
¿Es gratis?
Sí. Git es software libre y Git Bash viene incluido en el instalador oficial.
¿Puedo desinstalarlo sin perder mi código?
Sí. Tus archivos y el historial están en las carpetas de tus proyectos, no en el programa.
¿Estás empezando en programación? En nuestro catálogo de cursos técnicos encuentras formación desde cero, con acceso inmediato y de por vida.