Conferir ambientes

Gerador de .env.example

Documente as variáveis necessárias e confira o que permanece antes de exportar.

Gerador de .env.example

Origem .env

Prévia de .env.example

Processamento no navegador. Entradas ficam na memória, sem URL, telemetria ou histórico local.

Opções do modelo

Atribuições: 5 · Substituídas: 5 · Mantidas: 0 · Duplicadas: 0 · Comentários originais: 2

Comentários, descrições e valores mantidos ainda podem conter segredos. A ferramenta não garante que o arquivo possa ser publicado.

Quem chega a um projeto precisa saber quais variáveis de ambiente preencher, sem receber a configuração particular de outra pessoa. O Gerador de .env.example aproveita as declarações existentes e esvazia os valores primeiro. A lista de exceções começa vazia para que cada valor mantido seja uma decisão sua.

Um arquivo de exemplo também registra ajustes opcionais e definições repetidas. A ferramenta não remove essas declarações nem tenta escolher a última: preserva cada ocorrência. Isso facilita revisar a configuração que foi fornecida, sem confundir a geração de documentação com a resolução do ambiente de execução.

Por que usar o Gerador de .env.example?

Tratar valores multilinha por inteiro

O Gerador de .env.example lê strings entre aspas como um único valor, inclusive quando há várias linhas. Uma chave longa não deixa um trecho no resultado por ter sido tratada com uma substituição linha a linha. Erros de sintaxe interrompem a geração.

Dois painéis mantêm os marcadores das variáveis e dos comentários, enquanto os espaços preenchidos ficam vazios.

Manter só a exceção que você escolheu

Um PORT conhecido pode ajudar a iniciar o projeto. Informe esse nome na lista e acrescente uma descrição do uso esperado. Não há uma regra que preserve todos os números ou booleanos por considerá-los automaticamente inofensivos.

Uma linha escolhida mantém o valor e as demais ficam vazias, com barras de descrição acima das atribuições.

Ajustes que merecem atenção

01

Confira a escrita dos nomes

A lista de exceções diferencia maiúsculas e minúsculas e aceita separação por espaços ou vírgulas. Todas as ocorrências de um nome são mantidas. Nomes que não existem na origem aparecem em um aviso, sem criar novas variáveis.

02

Escreva explicações em separado

Use KEY=descrição em uma linha por nome, sem repetir a chave nessa lista. A explicação será um comentário acima de cada ocorrência. Você pode remover comentários antigos e continuar incluindo as descrições novas.

03

Revise novamente após mudar opções

No automático, a prévia é recalculada após 350 ms. Desative esse modo para usar Ctrl/Cmd + Enter. Uma alteração cancela a confirmação anterior; exportar exige uma prévia atualizada e outra confirmação da revisão.

Conteúdo preparado para quem vai configurar

Declarações completas, na mesma ordem

O prefixo export permanece quando já existe. Atribuições sem valor continuam na lista, e nomes repetidos recebem a mesma política em cada ocorrência. Os contadores mostram quantas atribuições foram substituídas e quantas foram mantidas para conferir o alcance das exceções.

Placeholders definidos por você

No lugar do valor vazio, escolha um texto como YOUR_VALUE_HERE. Ele é escrito entre aspas, com aspas internas e barras invertidas escapadas. Texto vazio, quebras de linha e caracteres de controle são rejeitados; o marcador não pode gerar outra atribuição.

Comentários antigos e novos

A opção de comentários originais afeta linhas de comentário e comentários após os valores. Linhas em branco continuam. Descrições adicionadas ganham # no início e não dependem da opção de preservar os comentários existentes.

O que a ferramenta não verifica

Limpar valores não certifica o arquivo
Uma exceção pode preservar uma senha; um comentário também pode citar dados confidenciais. Não há scanner que decida o que é seguro. Revise o resultado completo antes de incluí-lo no repositório, mesmo que todos os valores comuns estejam vazios.
Limites do formato aceito
Nomes usam letras ASCII, números e sublinhado, sem número no início. Valores entre aspas simples ou duplas podem ocupar várias linhas. Atribuições inválidas, aspas sem fechamento e NUL bloqueiam a saída. Origem e resultado têm limite de 1 MiB cada; a origem aceita até 10.000 atribuições.
Nenhuma execução ou busca no projeto
O Gerador de .env.example não expande referências como ${HOST}, executa comandos ou procura nomes ausentes no código. Também não cria senhas, mescla modelos, ordena chaves ou remove repetições. O arquivo usa finais de linha LF.
Descrições precisam corresponder a nomes
Cada descrição ocupa uma linha física e identifica um nome válido e único na lista. Caracteres de controle não são aceitos. Nomes desconhecidos são informados, mas não geram variáveis; a ferramenta não adivinha o propósito de uma chave.

Dúvidas sobre o Gerador de .env.example

Como o exemplo difere do .env real?

O .env usado pela aplicação contém os valores reais da sua configuração. O exemplo mostra os nomes que outra pessoa deve preencher. Um campo vazio ou marcador não garante que a aplicação funcione: as credenciais e os valores corretos precisam ser definidos no ambiente de destino.

Posso inserir segredos reais?

O conteúdo é processado no navegador. Ainda assim, revise o que será exportado: valores escolhidos como exceção e textos em comentários ou descrições podem continuar confidenciais. A confirmação de revisão não substitui a análise humana desse conteúdo.

Funciona com configurações de vários frameworks?

Sim, desde que as atribuições respeitem o formato aceito. Não existem presets de framework nem verificação dos campos necessários para Django, Laravel ou Next.js. O resultado documenta apenas as declarações que você já incluiu na origem.

Os comentários são mantidos?

Sim, por padrão, incluindo comentários em linhas próprias e depois dos valores. Desative a opção para removê-los juntos. As descrições novas são independentes: continuam como comentários mesmo com a preservação dos originais desligada.

Posso definir outro placeholder?

Sim. No modo de preenchimento, escolha uma string não vazia de uma única linha. Aspas e barras invertidas são escapadas. A substituição vale até para atribuições originalmente vazias, mas não altera os valores dos nomes incluídos nas exceções.

Dúvida sobre um valor ou uma regra?

Entregue uma base clara para a equipe

Use o Gerador de .env.example para conferir as exceções e as explicações no mesmo resultado. Depois da revisão completa, copie ou baixe o modelo.