Como Se Escreve Enrolado

O guia prático para escrever enrolado sem errar

A maioria das pessoas nunca pensa em como organizar o código até algo quebrar no meio de uma release. Eu descobri isso da pior forma possível, num projeto de automação que precisava lidar com strings enormes vindas de arquivos CSV mal formatados. O resultado foi um inferno de linhas que não cabe mais na tela e que demora trinta segundos pra depurar. O problema não era a lógica, era a forma como eu escrevia os trechos que ficavam longos demais pra caber numa linha só. Escrever enrolado significa basicamente dividir um comando ou expressão grande em várias linhas mantendo a legibilidade e a estrutura intacta. No JavaScript isso pode ser tão simples quanto quebrar uma template string com parênteses. Em Python a sintaxe exige vírgula ou colchetes abertos. Em SQL, o negócio fica ainda mais delicado porque os motores são teimosos com ponto e vírgula. O que eu aprendi na prática é que não adianta só quebra-line cego. Existe um padrão que funciona na maioria das vezes e você pode aplicá-lo em qualquer linguagem. Primeiro, identifique os pontos de quebra lógicos: depois de vírgulas, operadores binários, antes de parenteses abertos, ou entre chaves. Segundo, mantenha a indentação consistente em relação ao nível anterior. Terceiro, evite linhas que contenham apenas um parêntese sozinho, porque isso cria ruído visual.

Como fazer na prática

Vamos pegar um exemplo concreto que eu uso sempre que preciso reorganizar código longo. Suponha que você tenha uma função de busca que constrói uma query SQL dinâmica com dezenas de condições. A versão original ficava assim: Essa linha tem 157 caracteres. A maioria dos editores modernos já sinaliza isso como problema de legibilidade. O jeito certo de reescrever é usando concatenção de template strings no JavaScript ou interpolação no Python. No meu caso, eu transformei tudo assim: Note que cada parte da query ganhou sua própria linha e que os operadores ficam alinhados à esquerda. Isso é o essencial do como se escreve enrolado: manter a indentação coerente e separar claramente as partes lógicas.

Outro exemplo que eu vejo todo dia é com arrays e objetos grandes. Quando você precisa declarar uma lista de parâmetros, não tente colocar tudo numa linha só. Quebre depois das vírgulas e alinhe os elementos. Funciona igual pra JSON, pra listas de importação, pra configurações de build.

Erros comuns que todo mundo comete

O erro número um é esquecer de fechar um parêntese ou colchete antes de fazer o break. Isso gera erro de sintaxe e o compilador não ajuda muito a encontrar onde está o problema. Outro erro comum é usar espaços extras no início da linha quando não deveria. Alguns editores formatadores automáticos fazem isso e você acaba com um código desconfigurado que quebra a leitura. Também tem gente que quebra linha no meio de um identificador ou dentro de uma string literal. Isso é errado e vai te causar dor de cabeça na hora de versionar o código. Linhas de git diff ficam impossíveis de ler quando alguém inseriu um espaço no meio de uma palavra.

Alternativas quando o método padrão não funciona

Existem casos em que escrever enrolado do jeito tradicional não resolve. Um deles é quando você está lidando com expressões regulares que já são longas por natureza. Outro é quando trabalha com pipelines de dados em Python usando bibliotecas como pandas. Nesses cenários, eu recomendo extrair partes do código em funções menores ou usar constantes intermediárias. Assim você reduz a complexidade visual sem precisar force um quebra de linha artificial. Se o seu caso for especificamente SQL complexo com várias junções, considere usar CTEs. Elas transformam um monólito em blocos independentes que ficam mais fáceis de manter e de ler. Eu já vi equipes inteiras migram esse tipo de procedure pra CTE e o tempo de debug caiu de horas pra minutos.

Dicas técnicas que realmente fazem diferença

A primeira dica é configurar seu editor com um limite de linha visível. A maioria dos IDEs permite isso. Coloque em 100 ou 120 caracteres e deixe o editor te avisar quando passar disso. A segunda é usar um formatter automático. Ferramentas como Prettier pra JavaScript, Black pra Python ou sqlfluff pra SQL salvam muito tempo e evitam sobre estilo de formatação dentro da equipe. A terceira dica é mais sutil mas muito importante: mantenha uma convenção consistente dentro do mesmo arquivo. Se você usa uma linha vazia entre cláusulas em SQL, faça isso em todas as queries do arquivo. Se usa vírgula antes ou depois do break em arrays, escolha uma coisa e siga até o fim.

Quando não escrever enrolado

Às vezes o código mais legível é o mais curto. Linhas que já estão dentro do limite razoável não precisam ser quebradas. Não transforme tudo em múltiplas linhas só por seguir uma regra cega. O objetivo é clareza, não quantidade de linhas. Se uma expressão couber confortavelmente numa linha e fizer sentido, deixe ela assim. Um cenário em que eu desisto do formateiro é quando estou escrevendo código temporário, scripts de emergência ou trechos que vou refatorar em seguida. Nesses casos, performance de escrita importa mais do que beleza. Mas mesmo nesses trechos, eu tento manter uma estrutura mínima que permita entender o que está acontecendo quando eu voltar depois.

Como ajustar o fluxo de trabalho pro seu dia a dia

O jeito como se escreve enrolado ideal depende do que você faz o tempo todo. Se você dedica a maior parte do tempo a queries SQL, Foque em ferramentas como o SQLFormatter ou em extensões do VS Code que dão highlight de linha. Se seu foco é JavaScript ou TypeScript, o Prettier com configuração de max-len resolve 90% dos problemas. Para Python, o Black é quase automático e não deixa margem pra discussão. No meu caso, eu configurei o editor pra formatar automaticamente em save. Isso elimina a necessidade de pensar em formatação no momento da escrita e deixa o código limpo sem esforço adicional. O resultado é que eu passo menos tempo discutindo onde quebrar linha e mais tempo pensando na lógica de verdade. Se você está começando agora e quer dominar esse aspecto, a prática recomendada é pegar um projeto existente seu, aplicar o formatter e observar as mudanças. Repita o processo em dois ou três projetos diferentes e você vai internalizar o padrão naturalmente. Leva cerca de uma semana pra virar hábito, mas o ganho em produtividade compensa muito acima disso.