Debes nombrar una variable con el mismo cuidado con que nombras a un hijo primogénito. — Robert C. Martin
—¿Qué perdura después de esta línea?
El peso de un buen nombre
La frase de Robert C. Martin convierte una tarea técnica en una decisión casi moral: nombrar una variable no es un gesto menor, sino un acto de responsabilidad. Al compararlo con el nombre de un hijo primogénito, subraya que ese identificador acompañará al código durante mucho tiempo y afectará la forma en que otros lo entiendan, lo mantengan y lo modifiquen. Desde ahí, la idea central se vuelve clara: un buen nombre no solo describe, también orienta. En Clean Code (2008), Martin insiste en que el código debe comunicar intención; por eso, una variable bien nombrada reduce dudas, evita errores y hace que la lógica del programa parezca más natural al lector.
Legibilidad antes que brevedad
A continuación, la cita cuestiona una vieja costumbre de la programación: abreviar por comodidad. Nombres como x, tmp o val pueden parecer rápidos de escribir, pero suelen trasladar el esfuerzo al siguiente lector, que debe adivinar su propósito. En cambio, identificadores como totalFactura, fechaDeVencimiento o usuarioAutenticado expresan contexto y función desde el primer vistazo. Así, la legibilidad deja de ser un lujo estilístico para convertirse en una herramienta práctica. Martin argumenta en Clean Code (2008) que el código se lee mucho más de lo que se escribe; por lo tanto, invertir unos segundos en un nombre claro puede ahorrar horas de depuración, revisión y mantenimiento.
El nombre como diseño
Sin embargo, la cita va más allá de la claridad superficial: también sugiere que nombrar bien es una forma de diseñar bien. Cuando un programador lucha por encontrar el nombre exacto de una variable, a menudo descubre que todavía no entiende del todo el concepto que intenta representar. Esa incomodidad, lejos de ser un obstáculo, suele señalar una oportunidad para refinar la idea. En ese sentido, el nombre actúa como una prueba conceptual. Si una variable necesita una etiqueta confusa o excesivamente ambigua, quizá el modelo del dominio está mal definido. De manera similar, Martin Fowler muestra en Refactoring (1999) que renombrar elementos no es cosmético, sino una mejora estructural que hace visible la intención del sistema.
Empatía con quien leerá después
Además, la comparación con un hijo introduce una dimensión humana: nombrar bien implica pensar en el futuro y en los demás. El código rara vez permanece en manos de una sola persona; pasa por equipos, revisiones, herencias técnicas y cambios de contexto. Por eso, una variable bien bautizada funciona como un pequeño acto de empatía hacia quien llegará después, quizá meses más tarde, a interpretar esa decisión. En consecuencia, el nombre deja de servir solo al autor original. Como recuerda Martin, el código limpio es aquel que otros pueden leer sin fricción innecesaria. Un identificador claro dice: “ya hice parte del trabajo por ti”, y esa cortesía técnica fortalece la colaboración y reduce la dependencia de explicaciones externas.
Precisión frente a ambigüedad
Finalmente, la frase también advierte contra los nombres vagos que aparentan utilidad pero esconden confusión. Palabras como data, info, thing o manager pueden sonar aceptables al principio, aunque a menudo dicen demasiado poco. La precisión, en cambio, obliga a distinguir entre saldoPendiente, historialDeCompras o controladorDeSesión, y esa diferencia mejora la comprensión general del sistema. Por ello, nombrar variables con cuidado no es una manía perfeccionista, sino una disciplina que preserva la calidad del software. Igual que un nombre propio carga identidad, un buen identificador transmite propósito, límites y contexto. En última instancia, la enseñanza de Robert C. Martin es simple: escribir código claro empieza por llamar a cada cosa por lo que realmente es.
Un minuto de reflexión
¿Qué sentimiento te despierta esta cita?
Citas relacionadas
2 seleccionadasNo basta con que el código funcione. — Robert C. Martin
Robert C. Martin
A primera vista, la frase de Robert C. Martin parece sencilla, pero encierra una crítica profunda a una costumbre muy extendida: confundir funcionalidad con calidad.
Leer interpretación completa →Si quieres ir rápido, si quieres terminar rápidamente, si quieres que tu código sea fácil de escribir, haz que sea fácil de leer. — Robert C. Martin
Robert C. Martin
A primera vista, la frase de Robert C. Martin parece paradójica: para ir rápido, hay que detenerse a escribir código fácil de leer.
Leer interpretación completa →Más del autor
Más de Robert C. Martin →No basta con que el código funcione. — Robert C. Martin
A primera vista, la frase de Robert C. Martin parece sencilla, pero encierra una crítica profunda a una costumbre muy extendida: confundir funcionalidad con calidad.
Leer interpretación completa →Si quieres ir rápido, si quieres terminar rápidamente, si quieres que tu código sea fácil de escribir, haz que sea fácil de leer. — Robert C. Martin
A primera vista, la frase de Robert C. Martin parece paradójica: para ir rápido, hay que detenerse a escribir código fácil de leer.
Leer interpretación completa →