Perché mantenere le righe di codice di una lunghezza che ne faciliti la lettura?

Regola
Rispetta linee a un lunghezza lunghezza.
Righe che sono troppo lunghe sono difficili da leggere
e da navigare, soprattutto su schermi .

Lingue supportate: 45+

Introduzione

Le righe di codice troppo lunghe costringono a scorrere orizzontalmente, rendendo difficile seguire la logica e individuare i bug. Inoltre, complicano la revisione del codice e ne riducono la leggibilità su schermi di diverse dimensioni. Mantenere una lunghezza delle righe costante garantisce che il codice sia più facile da consultare, leggere e mantenere. Questa regola si applica a tutti i linguaggi e a tutti gli ambienti.

Perché è importante

Implicazioni per la sicurezza: le linee lunghe e fitte possono nascondere vulnerabilità o rendere più difficile individuare operazioni non sicure durante la revisione del codice.

Impatto sulle prestazioni: nessun impatto diretto sulle prestazioni, ma le code lunghe possono aumentare il carico cognitivo per gli sviluppatori, influendo indirettamente sulla produttività.

Manutenibilità del codice: le righe brevi e ben strutturate sono più facili da leggere, revisionare e modificare. Riducono gli errori e semplificano il debug.

Esempi di codice

❌ Non conforme:

function calculateTotal(items) { return items.reduce((sum, item) => sum + item.price * item.quantity, 0); }

Perché è importante: suddividere la riga in più segmenti migliora la leggibilità e rende più facile seguire la logica di riduzione.

✅ Conforme:

function calculateTotal(items) {
    return items.reduce(
        (sum, item) => sum + item.price * item.quantity,
        0
    );
}

Perché è importante: suddividere la riga in più segmenti migliora la leggibilità e rende più facile seguire la logica di riduzione.

❌ Non conforme (oggetto complesso):

const user = { id: 1, name: 'Alice', email: 'alice@example.com', roles: ['admin', 'editor'], active: true };

Perché è sbagliato: la riga è lunga e difficile da leggere a colpo d’occhio, soprattutto quando si esaminano più proprietà o si esegue il debug.

✅ Conforme:

const user = {
    id: 1,
    name: 'Alice',
    email: 'alice@example.com',
    roles: ['admin', 'editor'],
    active: true
};

Perché è importante: la formattazione su più righe migliora la leggibilità e la gestibilità del codice, rendendo più facile estendere o modificare le proprietà in un secondo momento.

Conclusione

Mantenete le righe di lunghezza ragionevole per migliorare la leggibilità, la manutenibilità e il rilevamento degli errori. Suddividete le istruzioni, gli oggetti e le chiamate di funzione troppo lunghe in più righe per maggiore chiarezza. Una formattazione coerente velocizza la revisione del codice e riduce il carico cognitivo per gli sviluppatori.