DEV Community

Cover image for 📝 Buen commit vs. Mal commit: Mejora tu árbol de Git
Roberto Morais
Roberto Morais

Posted on

📝 Buen commit vs. Mal commit: Mejora tu árbol de Git

¿Te ha pasado que vuelves a un proyecto después de meses y encuentras un commit llamado "arreglar cosas"? 😬 Sí, a todos nos ha pasado. ¡Pero no tiene que ser así! Hoy quiero hablarte de la importancia de escribir buenos commits y cómo pueden hacer tu vida (y la de tu equipo) mucho más fácil.

🤔 ¿Por qué importa un buen commit?

Un commit no es solo un "guardar partida" en tu código; es como una entrada en el diario de tu proyecto. Describe qué hiciste, por qué lo hiciste y, si es necesario, cómo lo hiciste. Los commits bien escritos:

✅ Facilitan entender el historial del proyecto.
✅ Ayudan a resolver bugs más rápido.
✅ Mejoran la colaboración en equipo.

Y lo más importante: te hacen ver como un profesional que sabe lo que hace. 😎

🚨 Ejemplo de mal commit

git commit -m "cambios"
Enter fullscreen mode Exit fullscreen mode

¿Cambios de qué? ¿Arreglaste algo? ¿Agregaste una funcionalidad? ¿Borraste medio repositorio? Nadie lo sabe. Ni siquiera tú lo sabrás en dos semanas. 😅

Otro clásico:

git commit -m "arreglo bug"
Enter fullscreen mode Exit fullscreen mode

Bien por arreglar el bug, pero... ¿qué bug? ¿En qué parte? Sin contexto, no sirve de mucho.

💡 Ejemplo de buen commit

git commit -m "fix: corregir validación de emails en el formulario de registro"
Enter fullscreen mode Exit fullscreen mode

🔍 Ahora sabemos exactamente qué se hizo y dónde. Si el bug regresa o surge algo relacionado, este commit será una brújula para encontrar la solución.

Otro ejemplo para nuevas funcionalidades:

git commit -m "feat: agregar funcionalidad para compartir enlaces en redes sociales"
Enter fullscreen mode Exit fullscreen mode

Esto no solo dice qué se hizo, sino que usa un convención estándar como Conventional Commits.

🎯 Tips para buenos commits

Usa una convención clara:

  • feat: para nuevas funcionalidades.
  • fix: para correcciones de bugs.
  • refactor: para mejorar código sin cambiar funcionalidad.
  • docs: para cambios en documentación.

Escribe mensajes descriptivos y precisos:
Un buen commit responde a estas preguntas:

¿Qué cambiaste?
¿Por qué lo cambiaste?
Haz commits pequeños y específicos:
No mezcles una nueva funcionalidad con arreglos de bugs en el mismo commit. Divide y vencerás.

Incluye contexto si es necesario:
Si estás corrigiendo un bug complicado, puedes usar el mensaje extendido:

git commit -m "fix: corregir error de autenticación al usar OAuth" -m "El error ocurría porque el token expiraba antes de ser validado. Se implementó una lógica para manejar tokens expirados."  
Enter fullscreen mode Exit fullscreen mode

🛠️ Herramientas útiles

Si quieres automatizar o mantener consistencia:

  • Commitizen: Guía para escribir mensajes siguiendo convenciones.
  • Husky: Ejecuta hooks de Git para validar commits.

🚀 ¡Haz que tus commits hablen por ti!

Un buen mensaje de commit no solo ayuda a tus compañeros de equipo, sino también a tu yo del futuro. Escribir buenos commits es una inversión pequeña con un gran retorno en claridad y productividad.

¿Tienes algún truco o convención que uses para tus commits? ¡Déjamelo en los comentarios! 👇

Billboard image

The fastest way to detect downtimes

Join Vercel, CrowdStrike, and thousands of other teams that trust Checkly to streamline monitoring.

Get started now

Top comments (0)

Heroku

This site is powered by Heroku

Heroku was created by developers, for developers. Get started today and find out why Heroku has been the platform of choice for brands like DEV for over a decade.

Sign Up

👋 Kindness is contagious

Immerse yourself in a wealth of knowledge with this piece, supported by the inclusive DEV Community—every developer, no matter where they are in their journey, is invited to contribute to our collective wisdom.

A simple “thank you” goes a long way—express your gratitude below in the comments!

Gathering insights enriches our journey on DEV and fortifies our community ties. Did you find this article valuable? Taking a moment to thank the author can have a significant impact.

Okay