Qué es el código limpio o clean code

Qué es el código limpio o clean code

El código limpio o clean code es una filosofía de desarrollo de software que enfatiza la importancia de escribir código claro, comprensible y que pueda mantenerse en el tiempo. No solo se trata de que el código funcione, sino de que también sea fácil de leer, modificar y extender, lo cual es crucial para la eficiencia y sostenibilidad a largo plazo en proyectos de software. En Área F5 hablamos en código, por eso vamos a profundizar un poco más en un tema de gran interés en los últimos años, ¡y en los que están por venir!

Orígenes del clean code: la filosofía de Robert C. Martin

El término Clean Code fue popularizado por Robert C. Martin, también conocido como ‘Tío Bob’, en su libro Clean Code: A Handbook of Agile Software Craftsmanship. Publicado en 2008, este libro se convirtió en una guía esencial para muchos programadores. Martin, con décadas de experiencia en programación, promovió la idea de que un buen código no solo funciona, sino que también es fácil de entender y mantener.

Esta forma de pensar se centró en reducir la complejidad del código para mejorar la calidad y eficiencia del desarrollo de software, ¡y debemos decir que funciona de maravilla!

Principios fundamentales del código limpio

El clean code se basa en una serie de pilares que guían a los desarrolladores a escribir código de mejor calidad. Estos principios no solo mejoran la legibilidad del código, también facilitan su mantenimiento y su posterior ampliación. Conocer cuáles son es vital para poder trabajar de acuerdo a sus preceptos.

Importancia de los nombres

Los nombres en el código deben ser descriptivos y claros. Un buen nombre revela la intención y facilita la comprensión del propósito de una variable, función, clase o método. Por ejemplo, un nombre como ‘calculateTotalIncome’ es mucho más descriptivo que simplemente ‘calc’.

La regla del boy scout

Este principio sugiere dejar el código más limpio de lo que se encontró. Esto implica mejorar constantemente el código, incluso aunque sea con pequeños detalles, cada vez que se trabaja en él, lo que lleva a un mantenimiento más sencillo y a una base de código más saludable a largo plazo.

DRY, ¡no te repitas!

Este principio del clean code hace hincapié en la importancia de evitar la duplicación de código, asegurando una única representación en el código para cada pieza. La duplicación puede llevar a inconsistencias y dificultades a la hora de mantener el código.

Ser el verdadero autor del código

El código debe ser escrito como si fuera una historia clara y bien narrada. Cada función y clase debe tener un propósito claro y ser coherente con el resto del código. Esto facilita la comprensión y el mantenimiento del código por parte de otros desarrolladores.

H3: Comentar Solo lo Necesario

Los comentarios deben usarse con moderación y solo cuando sean necesarios para explicar por qué se hace algo, no qué se hace. Un código bien escrito suele ser autoexplicativo.

Tratamiento de errores

Saber cómo abordar los posibles errores en el código es crucial. Deben tratarse de manera que el código siga siendo claro y legible, sin sacrificar la funcionalidad.

Tests limpios

Las pruebas son una parte integral del desarrollo de software, por eso deben ser claras, rápidas, independientes y deben poder repetirse. Un buen conjunto de pruebas asegura que el código funcione como se espera y facilita futuras modificaciones.

 

Si has llegado hasta aquí buscando respuestas a tus preguntas acerca del clean code, esperamos que las hayas encontrado. Y si tienes más inquietudes del estilo, no te pierdas el resto de entradas del blog de Área F5, ¡entre proyecto y proyecto nos encanta dejarnos caer por aquí!