🚨 Errores comunes en Git y cómo solucionarlos (guía real de supervivencia)


https://user-images.githubusercontent.com/44003176/103466403-36a81780-4d45-11eb-90cc-167d210d7a52.png


Si usas Git a diario, hay algo que es inevitable:

❗ Vas a cometer errores.

Y no pasa nada 😄

De hecho, es parte del aprendizaje.

El problema no es equivocarse…

👉 el problema es no saber cómo salir del error.

En esta guía vas a aprender:

  • los errores más comunes en Git
  • cómo solucionarlos paso a paso
  • qué comando usar en cada caso
  • cómo evitar que vuelvan a ocurrir


🧠 Regla clave antes de empezar


Git casi siempre tiene solución.

Y en muchos casos:

👉 puedes volver atrás sin perder nada.



❌ Error 1 — Hacer commit sin querer (mensaje incorrecto)


Problema

git commit -m "asdf"

Solución

git commit --amend -m "Mensaje correcto"

❌ Error 2 — Olvidar añadir archivos (git add)


Problema

git commit -m "Cambios"

👉 pero no añadiste archivos



Solución

git add .
git commit --amend


❌ Error 3 — Subir archivo que no debía (ej: .env)


Problema

Subiste datos sensibles 😨



Solución rápida

git rm --cached archivo

Luego:

git commit -m "Elimina archivo sensible"

Solución correcta

Agregar a .gitignore:

.env


❌ Error 4 — Hacer push a la rama equivocada


Problema

Subiste cambios a main



Solución

git reset --soft HEAD~1

Luego:

git checkout rama-correcta
git commit


❌ Error 5 — Sobrescribir cambios con pull


Problema

git pull

👉 y pierdes cambios



Solución

git stash
git pull
git stash pop


❌ Error 6 — Conflictos al hacer merge


👉 Ya lo viste en el post anterior 😄

Solución:

  • editar archivo
  • resolver conflicto
  • git add
  • commit


❌ Error 7 — Usar git add . sin revisar


Problema

Subiste archivos innecesarios



Solución

git reset

Luego añade solo lo necesario:

git add archivo.js


❌ Error 8 — Borrar commits accidentalmente


Problema

git reset --hard HEAD~1

Solución (si no hiciste push)

git reflog

Luego:

git reset --hard ID_DEL_COMMIT


❌ Error 9 — Push rechazado


Problema

rejected (non-fast-forward)

Solución

git pull --rebase
git push


❌ Error 10 — Trabajar directamente en main


Problema

Cambios directos en producción 😨



Solución

git checkout -b nueva-rama


❌ Error 11 — Rebase mal hecho


Problema

Historial roto



Solución

git rebase --abort


❌ Error 12 — Forzar push sin cuidado


git push --force

👉 peligroso



Mejor alternativa

git push --force-with-lease


🧠 Comandos salvavidas


Estos te sacan de casi todo:

git status
git log
git reflog
git stash
git reset


🧠 Buenas prácticas para evitar errores


✔️ Usa ramas

✔️ Haz commits pequeños

✔️ Usa .gitignore

✔️ Haz pull antes de trabajar

✔️ Revisa con git status


🧠 Estrategia profesional


Antes de cualquier acción:

git status

Siempre.



📌 Resumen rápido


  Error	              Solución
  commit mal	      amend
  olvidaste add	      add + amend
  archivo sensible	  rm + gitignore
  push rechazado	  pull --rebase
  commit borrado	  reflog




🧠 Conclusión:


Git no es difícil…

👉 lo difícil es no conocer los errores.

Cuando dominas esto:

  • trabajas con confianza
  • solucionas problemas rápido
  • no entras en pánico 😄




Volver al post Pilar: