Numerar linhas

Como usar Numerar linhas

Quem aprendeu a programar nos anos 1980 conhece números de linha num sentido completamente diferente: em BASIC, cada linha de código precisava de um número explícito — `10 PRINT 'OLÁ'`, `20 GOTO 10`. Não era opcional; era a sintaxe da linguagem. O número de linha era o endereço da instrução, e `GOTO 100` significava literalmente saltar para a linha 100. Isso tornava a refatoração um pesadelo: inserir uma nova linha entre 10 e 20 exigia renumerar tudo, o que levou ao surgimento de convenções como usar múltiplos de 10 para deixar espaço. Editores modernos de BASIC chegaram a ter um comando `RENUM` que renumerava automaticamente o arquivo inteiro. Quando as linguagens estruturadas como C e Pascal substituíram o BASIC como linguagem de ensino nos anos 1990, os números de linha sumiram da sintaxe — mas continuaram indispensáveis como metadados de ferramenta.

Hoje os números de linha são onipresentes como sistema de referência. O formato de saída do `grep -n` inclui o número da linha para cada correspondência — é a diferença entre encontrar no arquivo e encontrar na linha 347 do arquivo. Mensagens de erro de compiladores e interpretadores como GCC, Python e rustc sempre incluem linha e coluna: `TypeError: unsupported operand type(s) for +: 'int' and 'str' (line 23)`. O formato de diff unificado do `git diff` usa cabeçalhos como `@@ -15,7 +15,9 @@` para indicar quais linhas foram alteradas — e revisores de pull request no GitHub e GitLab clicam em números de linha para adicionar comentários inline. Editores como VS Code e Vim têm comandos como `:23` que levam o cursor diretamente a uma linha específica.

Esta ferramenta resolve o problema inverso: você tem um bloco de texto sem numeração e precisa adicionar números para criar um documento referenciável. Casos de uso práticos: transformar uma lista de termos ou itens em formato numerado para incluir em documentação técnica; preparar pseudocódigo ou roteiro de apresentação com números de etapa; adicionar prefixos de linha a logs para criar referências cruzadas; criar exercícios ou provas com questões numeradas a partir de um rascunho. O separador e a largura de padding são configuráveis — `001.`, `1:`, `1 -` — dependendo do contexto onde o output será usado.