typescriptboas-praticas

TypeScript em modo estrito vale a pena mesmo em projeto pequeno?

strict: true parece exagero num script de fim de semana. Mas o custo de ligar cedo é muito menor do que o de migrar depois — e o ganho aparece antes do que se imagina.

Conhecer VPS
Por NullNinja5 min de leitura
Voltar pro blog
TypeScript em modo estrito vale a pena mesmo em projeto pequeno?

O argumento contra é sedutor, mas frágil

"É só um projeto pequeno" é a justificativa mais comum para pular strict: true. O raciocínio faz sentido no primeiro dia: menos fricção, menos erro de tipo para resolver, mais velocidade para prototipar. O problema é que projeto pequeno raramente fica pequeno — e ligar strict mode depois, com centenas de arquivos já escritos em modo permissivo, é ordens de grandeza mais caro do que ligar no commit inicial.

O que strict mode realmente pega

strict: true liga um conjunto de flags que, juntas, eliminam categorias inteiras de bug em tempo de compilação:

  • strictNullChecks — provavelmente o maior ganho isolado. Sem ele, undefined e null passam por qualquer tipo sem aviso, e o erro só aparece em runtime, geralmente em produção.
  • noImplicitAny — força tipar o que não foi inferido, em vez de deixar any silencioso drenar a segurança de tipos do resto do código.
  • strictFunctionTypes e strictPropertyInitialization — pegam inconsistências em assinatura de função e classe que passam despercebidas em revisão de código, porque "parecem" certas.

Em projeto pequeno, o volume de bugs evitados é proporcionalmente menor — mas o custo de corrigir cada um também é menor, porque o contexto ainda está fresco na cabeça de quem escreveu.

O custo real está na migração, não na adoção

A objeção válida contra strict mode nunca foi "vai me atrasar hoje" — é "vou ter que migrar um dia". E aí a conta inverte: projeto que nasce em modo permissivo acumula any implícito, acesso a propriedade potencialmente nula e função mal tipada em todo lugar. Quando alguém decide ligar strict mode depois, o resultado costuma ser centenas de erros de uma vez, muitos deles em código que ninguém mexe há meses.

Ligar desde o commit inicial custa perto de zero: o próprio editor já sinaliza os problemas enquanto o código é escrito, um por um, no contexto em que faz sentido corrigir.

Quando realmente não compensa

Existem exceções legítimas: script descartável que roda uma vez e morre, protótipo que será jogado fora em uma semana, código gerado automaticamente que não passa por revisão humana. Fora desses casos, a resposta prática é: se o código vai ser lido de novo por alguém (incluindo você mesmo, em três meses), strict mode paga o investimento inicial rapidamente.