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.
.avif)
