Escribir buenos mensajes de commit
El tú del futuro te lo va a agradecer
⏱ Estim. ~8 min
01 · Leer
Un buen mensaje de commit es un regalo para el tú del futuro (y para tu equipo). Debería explicar por qué hiciste el cambio, no solo qué cambió. Mensajes claros vuelven útil el historial de git.
💡 Imagínalo asíEscribir un buen mensaje de commit es como ponerle etiqueta al dorso de una foto. "Cumple 3 de Juan en casa de la abuela" ayuda. "Foto" no. Meses después, esas etiquetas son la única forma de recordar qué muestra cada instantánea.
Puntos clave
- Los buenos mensajes explican el por qué: 'Fix login timeout for slow connections'
- Los malos son vagos: 'fixed stuff', 'update', 'asdf'
- La primera línea va corta (menos de 50 caracteres), en imperativo: 'Add', 'Fix', 'Update'
02 · Práctica de terminal
Tienes un proyecto de blog con HTML y CSS. Vamos a practicar buenos mensajes de commit con el flujo completo.
(Esta sección es interactiva — activa JavaScript para usarla.)
03 · Práctica de terminal
Pon todos los archivos en stage para tu primer commit.
(Esta sección es interactiva — activa JavaScript para usarla.)
04 · Práctica de terminal
Tu primer commit debería describir qué incluye este proyecto. No escribas solo 'first commit': sé específico sobre tu punto de partida.
(Esta sección es interactiva — activa JavaScript para usarla.)
05 · Quiz
¿Cuál de estos mensajes de commit sigue las buenas prácticas?
- "fixed stuff"
- "Add user login validation for email format"
- "update"
- "changes"
06 · Práctica de terminal
Ahora agreguémosle una funcionalidad nueva al blog: una barra de navegación.
(Esta sección es interactiva — activa JavaScript para usarla.)
07 · Práctica de terminal
Pon el archivo modificado en stage.
(Esta sección es interactiva — activa JavaScript para usarla.)
08 · Práctica de terminal
Escribe un mensaje de commit para este cambio. Describe qué agregaste, no escribas solo 'update'. Buenos ejemplos: 'Add navigation bar to blog', 'Add nav links for Home, About, Contact'.
(Esta sección es interactiva — activa JavaScript para usarla.)
09 · Quiz
¿Cuál de estos mensajes de commit se ajusta mejor a las convenciones profesionales?
- "updated stuff"
- "asdfjkl"
- "Fix password reset for expired tokens"
- "I changed the login page to fix a bug where users couldn't log in when their session expired after 24 hours"
Otras lecciones de este capítulo
⚠ La experiencia interactiva completa necesita JavaScript. Actívalo y vuelve a cargar la página.
※ Este es un proyecto educativo independiente — no es un producto oficial de Anthropic. Claude™ es una marca registrada de Anthropic, PBC.