Qual é a diferença entre any e unknown no TypeScript, e quando você recorre a cada um?

O any desliga a checagem de tipos para aquele valor, então todo acesso a propriedade e toda chamada compila mesmo quando estão errados. O unknown aceita qualquer valor na entrada mas obriga você a estreitá-lo com uma checagem de typeof, um type guard ou um parse de schema antes de poder usar. Recorra a unknown nas fronteiras de confiança como respostas de fetch e JSON.parse. Recorra a any quase nunca.

A minha regra é que any é um bug que eu ainda não encontrei. Se eu escrevo any, eu falei para o compilador parar de ajudar e a falha aparece em tempo de execução no navegador de um usuário. O unknown é a versão honesta: ele diz eu não sei o que é isto, e o compilador me obriga a provar o formato antes de eu encostar. Na prática isso significa que qualquer coisa que atravessa uma fronteira de confiança começa como unknown. Uma resposta de fetch, o corpo de um webhook, o que quer que saia do JSON.parse ou do localStorage. Em uma fintech em que eu trabalhei a gente escrevia à mão os tipos de resposta da API e eles divergiram do backend em uns dois meses, então um campo que virou anulável começou a quebrar a renderização de uma tabela em produção. A gente passou a fazer parse com zod na fronteira e a inferir os tipos do TypeScript a partir do schema, e toda essa classe de bug desapareceu. O único lugar em que eu ainda permito any é dentro de um helper genérico bem restrito, e mesmo lá unknown mais um guard normalmente resolve.