Aikido

Por que manter as linhas de código com um comprimento legível

Legibilidade

Regra
Mantenha as linhas em um comprimento .
Linhas que também demasiado longas são difíceis para ler
e navegar, especialmente em ecrãs .

Idiomas suportados: 45+

Introdução

Linhas de código longas forçam a rolagem horizontal, dificultando o acompanhamento da lógica e a identificação de bugs. Elas também complicam as revisões de código e reduzem a legibilidade em diferentes tamanhos de tela. Manter um comprimento de linha consistente garante que o código seja mais fácil de navegar, ler e manter. Esta regra se aplica a todas as linguagens e ambientes.

Por que isso importa

Implicações de segurança: Linhas longas e densas podem ocultar vulnerabilidades ou tornar operações inseguras mais difíceis de identificar durante a revisão de código.

Impacto no desempenho: Nenhum impacto direto no desempenho, mas linhas longas podem aumentar a carga cognitiva para os desenvolvedores, afetando indiretamente a produtividade.

Manutenibilidade do código: Linhas curtas e bem estruturadas são mais fáceis de ler, revisar e modificar. Elas reduzem erros e simplificam a depuração.

Exemplos de código

❌ Não-conforme:

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

Por que isso importa: Dividir a linha em múltiplos segmentos melhora a legibilidade e facilita o acompanhamento da lógica de redução.

✅ Compatível:

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

Por que isso importa: Dividir a linha em múltiplos segmentos melhora a legibilidade e facilita o acompanhamento da lógica de redução.

Não conforme (objeto complexo):

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

Por que está errado: A linha única é longa e difícil de ler rapidamente, especialmente ao revisar múltiplas propriedades ou depurar.

✅ Compatível:

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

Por que isso importa: A formatação em múltiplas linhas melhora a legibilidade e a manutenibilidade, facilitando a extensão ou modificação de propriedades posteriormente.

Conclusão

Mantenha as linhas em um comprimento gerenciável para melhorar a legibilidade, manutenibilidade e detecção de erros. Divida declarações longas, objetos e chamadas de função em várias linhas para maior clareza. A formatação consistente torna as revisões de código mais rápidas e reduz a carga cognitiva para os desenvolvedores.

FAQs

Dúvidas?

Qual é o comprimento máximo de linha recomendado?

Geralmente de 80 a 120 caracteres, dependendo das convenções da equipe e dos tamanhos de tela. A consistência é mais importante do que o número exato.

Eu deveria quebrar linhas dentro de chamadas de função ou expressões?

Sim. Divida expressões longas, chamadas encadeadas e parâmetros em múltiplas linhas para melhorar a legibilidade.

Manter as linhas curtas afeta o desempenho?

Não. O comprimento da linha não impacta o runtime, apenas a legibilidade e a manutenibilidade.

Como lidar com strings longas ou URLs?

Divida-os em segmentos concatenados ou template literals, mantendo a legibilidade e o alinhamento.

Fique seguro agora

Proteja seu código, Cloud e runtime em um único sistema centralizado.
Encontre e corrija vulnerabilidades rapidamente de forma automática.

Não é necessário cartão de crédito | Resultados da varredura em 32 segundos.