• Inicio
  • Sobre mí
  • Proyectos
  • Blog
  • Contacto
← Volver al blog

Introducción a Clean Code: Principios básicos

enero 15, 2024

El Clean Code o código limpio es mucho más que seguir convenciones de estilo. Es una filosofía de programación que busca crear código que sea fácil de leer, entender y mantener.

¿Por qué es importante?

El código se lee muchas más veces de las que se escribe. Un código limpio:

  • Reduce el tiempo de desarrollo a largo plazo
  • Facilita la colaboración en equipo
  • Minimiza la cantidad de bugs
  • Mejora la escalabilidad del proyecto

Principios básicos

1. Nombres significativos

Los nombres de variables, funciones y clases deben revelar su intención:

// ❌ Mal
const d = new Date();
const x = calculatePrice(items);

// ✅ Bien
const currentDate = new Date();
const totalPrice = calculatePrice(items);

2. Funciones pequeñas

Una función debe hacer una sola cosa y hacerla bien:

// ❌ Mal - hace demasiadas cosas
function processUser(user) {
  validateUser(user);
  saveToDatabase(user);
  sendEmail(user);
  logActivity(user);
}

// ✅ Bien - cada función tiene una responsabilidad
function processUserRegistration(user) {
  if (!isValidUser(user)) return false;

  const savedUser = saveUser(user);
  sendWelcomeEmail(savedUser);
  logUserRegistration(savedUser);

  return savedUser;
}

3. Comentarios necesarios

El código debe ser autoexplicativo. Los comentarios solo cuando añaden valor:

// ❌ Mal
// Incrementa i en 1
i++;

// ✅ Bien
// Aplicamos el descuento solo si el cliente es premium y la compra supera 100€
if (customer.isPremium && totalAmount > 100) {
  applyDiscount(totalAmount, PREMIUM_DISCOUNT_RATE);
}

Conclusión

Adoptar Clean Code es un proceso gradual. Empieza aplicando estos principios en tu día a día y verás cómo tu código mejora significativamente.

¿Quieres profundizar más? Te recomiendo leer "Clean Code" de Robert C. Martin, es una referencia imprescindible.

← Volver a todos los posts