Analisador e validador de .env

Cole um ficheiro .env — ou largue-o na caixa — e receba-o analisado, verificado e explicado: cada chave numa tabela com o seu valor mascarado, cada problema listado com o seu número de linha. Chaves duplicadas, nomes inválidos, linhas que nem sequer são atribuições, valores vazios que substituem silenciosamente os valores predefinidos. Funciona inteiramente no seu navegador e o ficheiro nunca é enviado, porque um .env de produção é um pacote de segredos e deve ser tratado como tal.

O que é verificado, e porquê

O formato .env é uma convenção, não uma norma, e é por isso que os ficheiros apodrecem silenciosamente. Todos os carregadores concordam em KEY=VALUE e discordam em tudo o resto: se os prefixos export são removidos, se as aspas são respeitadas, se um comentário em linha termina um valor e — o mais perigoso — qual de duas definições da mesma chave vence. Este validador aplica as regras do denominador comum e reporta os pontos onde os carregadores divergem: uma chave definida duas vezes com ambos os números de linha, um nome que nenhuma shell aceitaria, uma aspa que abre e nunca fecha, uma linha sem qualquer sinal de igual. Os valores vazios são sinalizados em vez de reprovados, porque KEY= é legal — mas substitui qualquer valor predefinido da aplicação por uma cadeia vazia, que é a razão mais comum para um serviço funcionar numa máquina e não noutra.

O desenho de privacidade é a funcionalidade. Um .env de produção concentra palavras-passe de bases de dados, chaves de API e segredos de sessão num ficheiro pequeno, e o movimento natural de depuração — colá-lo algures e pedir ajuda — é também a fuga. Os chats de IA, os sistemas de tickets e os canais de equipa guardam cópias, muitas vezes pesquisáveis, muitas vezes para sempre. Por isso, esta ferramenta segue a mesma regra do analisador de registos e do gerador de certificados: a entrada sensível nunca sai do navegador, os valores são mascarados no ecrã e as únicas exportações são ficheiros que transfere deliberadamente. O artigo complementar, os ficheiros env são onde os segredos vão vazar, cobre a higiene em torno do próprio ficheiro — o que pertence a ele, o que não pertence e o que fazer quando um escapa.

Perguntas frequentes

É seguro colar aqui um .env de produção?

Sim — é esse o objetivo desta ferramenta. A análise corre inteiramente no seu navegador: não há envio, não há ida e volta ao servidor, e nada do que cola é transmitido ou armazenado em lado algum. Os valores são mascarados no ecrã por predefinição, pelo que uma partilha de ecrã ou uma captura também não os vazam. O mesmo não se pode dizer de colar um .env num chat de IA, num ticket ou numa mensagem de equipa, que guardam cópias — o artigo sobre ficheiros env e fugas de segredos explica os hábitos mais seguros.

Porque é que uma chave duplicada importa se a última vence?

Porque a pessoa que edita o ficheiro não sabe qual vence. Altera o valor na linha 4, volta a implementar e vê que nada acontece — o carregador usou silenciosamente a linha 41. Pior ainda, algumas estruturas tomam a primeira definição e outras a última, pelo que o mesmo ficheiro se comporta de forma diferente numa mesma pilha. Uma chave, uma linha, um valor: o validador lista cada duplicado com ambos os números de linha para que a linha morta possa ser apagada.

A minha aplicação lê uma variável que não está no .env. Como as encontro?

Cole o seu código ou configuração na caixa de utilização. O analisador extrai cada nome referenciado — process.env.X, process.env[’X’], import.meta.env.X, ${X} e $X — e reporta em ambas as direções: nomes que o código referencia e o ficheiro nunca define (tornam-se undefined em tempo de execução, normalmente no pior momento) e chaves que o ficheiro define e nada referencia (configuração morta que, surpreendentemente muitas vezes, ainda guarda segredos ativos).

O que conta como chave inválida?

Tudo o que não seja uma letra ou um sublinhado seguido de letras, dígitos e sublinhados. Chaves que começam por um dígito, contêm hífenes ou pontos ou têm espaços estranhos são descartadas ou adulteradas por muitos carregadores e shells — um ficheiro que carrega limpo em bash pode falhar num carregador Node exatamente por esta razão. O validador assinala-as com o número de linha; a tabela de entradas continua a mostrar a linha para que veja o que se perderia.

As exportações contêm os valores reais?

Sim. As transferências JSON e YAML e o JSON copiado são a configuração real — o mascaramento é uma proteção de visualização, não uma redação dos seus próprios dados. Trate os ficheiros exportados exatamente como o próprio .env: nunca os submeta a um repositório público, nunca os anexe a um ticket. Se precisar de uma versão segura para partilhar, partilhe a captura mascarada ou a lista de chaves.