Cos'è il clean code (principi)

C'è una frase famosa nel mondo dello sviluppo: il codice viene letto molte più volte di quante venga scritto. Per questo scrivere codice che funziona non basta: deve anche essere comprensibile. Questo è il cuore del clean code.

In questo articolo ti spiego cos'è il clean code e quali sono i principi fondamentali per scrivere codice pulito, con esempi concreti.

Cos'è il clean code in parole semplici

Il clean code è codice scritto in modo chiaro, semplice e leggibile, tale che chiunque (incluso chi l'ha scritto, a distanza di tempo) possa capirlo e modificarlo facilmente. Non è codice "elegante" per moda: è codice che comunica bene le proprie intenzioni.

Un programma è una forma di comunicazione: parli sia con la macchina sia con gli altri sviluppatori. Il clean code mette al centro questo secondo interlocutore, perché è lì che si gioca la manutenibilità di un progetto.

I principi fondamentali

1. Nomi che spiegano

Il nome di una variabile o funzione dovrebbe dire cosa contiene o cosa fa, senza bisogno di commenti.

# poco chiaro
d = 86400

# chiaro
secondi_in_un_giorno = 86400

Un buon nome fa risparmiare minuti di confusione a chi legge.

2. Funzioni piccole e con un solo compito

Una funzione dovrebbe fare una cosa sola e farla bene. Se per descriverla usi la parola "e", probabilmente fa troppo. Funzioni corte sono più facili da capire, testare e riutilizzare.

3. DRY – Don't Repeat Yourself

Evita di duplicare la stessa logica in più punti. Se devi modificarla, rischi di dimenticarne una copia e introdurre bug. Meglio scriverla una volta sola in una funzione.

// invece di ripetere il calcolo ovunque
function conIva(prezzo) {
  return prezzo * 1.22;
}

4. KISS – Keep It Simple

Non complicare le cose senza motivo. La soluzione più semplice che funziona è quasi sempre la migliore. Il codice "furbo" e contorto impressiona meno di quanto pensi e crea solo problemi.

I commenti: meno è meglio

Un mito da sfatare: tanti commenti non significano codice pulito. Anzi, spesso un commento è il segno che il codice non si spiega da solo. Il clean code preferisce un buon nome a un commento esplicativo.

# commento che compensa un nome scarso
x = x * 7   # converti settimane in giorni

# meglio: il codice si spiega da solo
giorni = settimane * 7

I commenti restano utili per spiegare il perché di una scelta non ovvia, non il cosa (che dovrebbe già essere chiaro dal codice).

Clean code, refactoring e test

Il clean code non è un traguardo che raggiungi una volta sola: è un'abitudine. Spesso lo ottieni tramite il refactoring, migliorando il codice a piccoli passi. E per farlo in sicurezza ti servono dei test che ti dicano se hai rotto qualcosa.

Anche conoscere i paradigmi di programmazione aiuta: spesso una struttura più pulita nasce dalla scelta dell'approccio giusto per il problema.

Un consiglio onesto per chi inizia

Se stai imparando a programmare da zero, non bloccarti sulla perfezione. All'inizio l'obiettivo è far funzionare le cose. Il clean code si coltiva nel tempo, leggendo molto codice altrui e rivedendo il proprio con occhio critico. Comincia con i nomi chiari e le funzioni piccole: sono i due principi che danno il maggior beneficio con il minimo sforzo.

In sintesi

Il clean code è codice leggibile, semplice e facile da modificare. I suoi pilastri sono nomi chiari, funzioni piccole, niente duplicazioni (DRY) e semplicità (KISS). Più che un insieme di regole rigide, è un atteggiamento: scrivere pensando a chi leggerà.

Vuoi imparare a scrivere codice pulito fin dai tuoi primi programmi, con esempi e revisioni guidate? Lo trovi nei corsi di CodeGrind.