Cos'è il clean code (principi)
Clean code spiegato semplice: cos'è, i principi fondamentali per scrivere codice pulito e leggibile con esempi pratici. Nomi chiari, funzioni piccole e DRY.
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.