Aikido

Why keep code lines at a readable length in code

Leggibilità

Regola
Mantieni le righe a una lunghezza leggibile.
Le righe troppo lunghe sono difficili da leggere

e da navigare, soprattutto su schermi più piccoli.

Linguaggi supportati: 45+

Introduzione

Righe di codice troppo lunghe costringono a uno scorrimento orizzontale, rendendo difficile seguire la logica e individuare i bug. Complicano inoltre le code review e riducono la leggibilità su schermi di diverse dimensioni. Mantenere una lunghezza di riga coerente assicura che il codice sia più facile da navigare, leggere e manutenere. Questa regola si applica a tutti i linguaggi e ambienti.

Perché è importante

Implicazioni sulla sicurezza: Righe lunghe e dense possono nascondere vulnerabilità o rendere le operazioni non sicure più difficili da individuare durante la code review.

Impatto sulle prestazioni: Nessun impatto diretto sulle prestazioni, ma le righe lunghe possono aumentare il carico cognitivo per gli sviluppatori, influenzando indirettamente la produttività.

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

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ù semplice 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ù semplice 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é è errato: La riga singola è lunga e difficile da esaminare, soprattutto quando si revisionano più proprietà o si esegue il debugging.

✅ Conforme:

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

Perché è importante: La formattazione multilinea migliora la leggibilità e la manutenibilità, rendendo più semplice estendere o modificare le proprietà in un secondo momento.

Conclusione

Mantieni le righe a una lunghezza gestibile per migliorare leggibilità, manutenibilità e rilevamento degli errori. Suddividi istruzioni, oggetti e chiamate di funzione lunghi su più righe per maggiore chiarezza. Una formattazione coerente rende le code review più rapide e riduce il carico cognitivo per gli sviluppatori.

FAQ

Hai domande?

Qual è la lunghezza massima consigliata per una riga?

In genere tra 80 e 120 caratteri, a seconda delle convenzioni del team e delle dimensioni dello schermo. La coerenza è più importante del numero esatto.

Dovrei interrompere le righe all'interno di chiamate di funzione o espressioni?

Sì. Suddividi espressioni lunghe, chiamate concatenate e parametri su più righe per migliorare la leggibilità.

Mantenere le righe corte influisce sulle prestazioni?

No. La lunghezza delle righe non influisce sul runtime, ma solo sulla leggibilità e sulla manutenibilità.

Come posso gestire stringhe lunghe o URL?

Suddividili in segmenti concatenati o template literal, mantenendo la leggibilità e l'allineamento.

Metti in sicurezza ora

Metti in sicurezza il tuo codice, il cloud e il runtime in un unico sistema centralizzato.
Trova e risolvi le vulnerabilità rapidamente e automaticamente.

Nessuna carta di credito richiesta | Risultati della scansione in 32 secondi.