Como usar: Validador de Arquivo .env
- Cole seu
.envna caixa da esquerda. Opcionalmente, cole o.env.example(ou uma lista de chaves obrigatórias) na da direita. - Leia a lista de problemas: erros quebram a leitura, avisos indicam prováveis equívocos ou valores arriscados.
- Confira a tabela de cada variável — os valores são mascarados, então você pode compartilhar uma captura de tela com segurança.
- Baixe o
.env.examplegerado e faça commit dele no lugar do seu.envreal.
Sintaxe do .env em resumo
| Linha | Resultado |
|---|---|
PORT=3000 | Valor simples |
APP_NAME="My App" | Aspas necessárias para espaços |
GREETING='Hello $USER' | Aspas simples: sem expansão de variáveis (dotenv-expand, Docker Compose) |
KEY="line1\nline2" | Aspas duplas: \n vira quebra de linha |
export TOKEN=abc | O prefixo export é permitido e ignorado pelo dotenv |
# comment | Comentário; após um valor, só quando precedido de espaço e o valor não estiver entre aspas |
Erros comuns que este validador detecta
- Chaves duplicadas — a maioria dos carregadores mantém silenciosamente o primeiro ou o último valor, então as alterações parecem não ter efeito.
- Espaços ao redor de = ou em valores sem aspas —
KEY = valuequebra em shells e no Docker. - Aspas não fechadas que engolem as linhas seguintes.
- Nomes inválidos — chaves devem conter letras, números e underscores e não começar com dígito.
- Segredos como chaves AWS, chaves live do Stripe, tokens do GitHub ou chaves privadas — tudo bem em um .env local, mas nunca faça commit deles.
Mantenha o .env fora do Git
Adicione .env ao seu .gitignore e faça commit de um .env.example apenas com as chaves. No CI, guarde os valores como secrets — veja o GitHub Actions Workflow Generator. Frameworks front-end expõem variáveis com prefixos como VITE_, NEXT_PUBLIC_ ou PUBLIC_ para o navegador — nunca coloque segredos neles.
Também pesquisado como: checker de .env, validador dotenv, gerador de env example, verificar variáveis de ambiente, variáveis de ambiente faltando, sintaxe dotenv, formato de arquivo env.
Ferramentas que combinam com: Validador de Arquivo .env
- Gerador do Docker Compose — Marque os serviços que você precisa — aplicativo, banco de dados, cache, interface de administração, captador de e-mails — e receba um arquivo `compose.yaml` limpo com imagens fixadas, volumes nomeados, verificações de integridade e depends_on condições, além de um arquivo .env correspondente com senhas geradas.
- Gerador de package.json — Preencha o formulário e receba um package.json válido — validação do nome no npm, predefinições de scripts para Vite, Next.js, Node e bibliotecas TypeScript, exports, engines, licença e repositório — com avisos sobre erros comuns.
- Inspetor de Caracteres Unicode — Cole qualquer texto para ver do que ele é feito de verdade: o nome, ponto de código, bytes UTF-8 e código HTML de cada caractere.
- Verificador de Diferenças — Cole uma versão original e uma versão alterada para ver lado a lado as linhas adicionadas, removidas e modificadas — com as palavras exatas que mudaram destacadas dentro de cada linha.
Perguntas frequentes
É seguro colar meu .env aqui?
O validador roda apenas no seu navegador; nada é enviado nem armazenado. Os valores são mascarados no relatório. Mesmo assim, evite colar segredos de produção em qualquer site se a sua política não permitir — use o arquivo de exemplo.
Preciso de aspas em um arquivo .env?
Só quando o valor contém espaços, #, aspas ou quebras de linha, ou começa com um caractere especial. Aspas duplas permitem escapes como \n; aspas simples mantêm o valor literalmente.
Para que serve o .env.example?
Ele documenta quais variáveis o projeto precisa, sem valores reais. Faça commit dele para que novos colegas e o CI saibam o que configurar; mantenha o .env real fora do Git.
Por que minha variável continua undefined?
Causas comuns: erro de digitação ou letra maiúscula/minúscula diferente na chave, uma duplicata mais abaixo no arquivo, espaços ao redor de =, uma aspa não fechada acima dela, ou o arquivo não está sendo carregado (pasta errada ou configuração do dotenv ausente). Bundlers front-end também exigem prefixos como VITE_ ou NEXT_PUBLIC_.
Posso instalar o Validador de Arquivo .env como um aplicativo da web e usá-lo offline?
Sim. O Validador de Arquivo .env é um aplicativo da web instalável (PWA) — instalado a partir do seu navegador, não baixado de uma loja de aplicativos. Clique em “Instalar aplicativo” na parte superior desta página no Chrome ou no Edge (Windows, macOS, Linux, ChromeOS) ou, no Android, use “Compartilhar” → “Adicionar à tela inicial” no iPhone e no iPad, ou “Arquivo” → “Adicionar ao Dock” no Safari 17+ em um Mac. Em seguida, ela se abre em uma janela própria com seu próprio ícone e, como é executada inteiramente no seu navegador, continua funcionando offline. O Firefox no desktop não permite a instalação de aplicativos da web. Como funciona a instalação.