.env ⇄ JSON — Conversor

O que o .env ⇄ JSON faz

O .env ⇄ JSON converte entre o formato chave-valor do dotenv e um objeto JSON plano. A direção .env para JSON analisa cada linha como uma propriedade, ignorando linhas em branco e comentários iniciados por #, removendo espaços ao redor e eliminando o prefixo opcional export. Valores entre aspas simples ou duplas são desembrulhados e, dentro de aspas duplas, sequências de escape comuns como \n e \t são expandidas, para que segredos de várias linhas e valores formatados sobrevivam à conversão de ida e volta. A direção JSON para .env percorre um objeto JSON e escreve uma linha KEY=value por propriedade, colocando entre aspas qualquer valor que contenha espaços, quebras de linha ou caracteres que seriam ambíguos para um analisador dotenv.

Isso é útil ao mover configurações entre ferramentas que esperam formatos diferentes: importar o ambiente de um colega para uma interface de configurações, gerar um .env inicial a partir de um bloco de configuração JSON, comparar variáveis entre ambientes ou preparar um arquivo de exemplo para a documentação. O conversor segue as convenções dotenv mais difundidas, e não a sintaxe estendida de uma biblioteca específica, de modo que a saída permanece previsível e fácil de revisar.

Fluxo de trabalho privado no navegador

Toda a análise e serialização acontece dentro do seu navegador, com JavaScript no lado do cliente. A ferramenta não envia a um servidor o seu arquivo de ambiente, JSON, nomes de host, tokens ou credenciais, e não exige conta. Esse comportamento exclusivamente local é especialmente importante aqui, pois arquivos .env costumam guardar senhas de banco de dados, chaves de API e segredos de assinatura. Fazer a conversão na sua máquina significa que esses valores nunca saem da página e não há viagem pela rede entre colar e obter o resultado.

A interface mantém origem e saída visíveis para que você confirme a conversão antes de copiar. Mesmo com o trabalho sendo local, remova segredos reais antes de compartilhar qualquer resultado em uma issue, chat ou documentação, e nunca faça commit de um arquivo .env preenchido no controle de versão.

Dicas práticas

Ao converter de JSON para .env, mantenha os valores como strings quando a aplicação de destino esperar strings, já que o dotenv trata todo valor como texto. Booleanos, números e objetos aninhados são convertidos em strings, e objetos aninhados são escritos como JSON para sobreviver à conversão de ida e volta; achate-os antes se o seu carregador não consegue interpretar valores JSON. Ao converter de .env para JSON, chaves duplicadas resolvem para a última atribuição, como a maioria dos carregadores dotenv. Valide sempre a configuração final com o framework que vai lê-la, porque regras sutis de aspas e interpolação variam entre implementações do dotenv.