Importar e exportar variáveis
Traga um .env inteiro para um projeto com pré-visualização antes de gravar, e baixe um ambiente completo no formato que o seu deploy consome.
Importe um .env
- 1
Na matriz do projeto, clique em `Importar variáveis`.
O assistente abre em duas etapas.
- 2
Etapa `Conteúdo`: forneça o texto e marque os `Ambientes de destino`.
Arraste um arquivo, escolha um ou cole o texto (limite de 1 MiB). Cada ambiente de destino tem o interruptor
só as chaves (valor vazio), que semeia a estrutura sem copiar valores — útil para criar as lacunas de produção a partir do dev. - 3
Clique em `Pré-visualizar` e revise a tabela.
O texto bruto vai ao servidor, cujo parser endurecido (PEM multilinha, comentários, aspas, BOM, CRLF, duplicatas) é a fonte da verdade. A tabela mostra, por chave e por ambiente, o badge
nova,mudaouigual, além dos avisos do parser, e permite excluir linhas. Nada é gravado nesta etapa. - 4
Clique em `Importar N chave(s)`.
resultadoAs chaves são gravadas nos ambientes marcados e a matriz reflete o resultado.
Importar nunca apaga
A gravação tem semântica de merge: chaves ausentes do arquivo permanecem intocadas. Reimportar o mesmo arquivo é um no-op — nenhuma versão nova é gravada.
Exporte um ambiente
Exportar variáveis baixa um ambiente inteiro em .env, JSON, YAML ou Docker (--env-file). O download sai em texto puro e é auditado — uma linha no histórico do projeto listando as chaves exportadas.
- A exportação
.envescapa quebras de linha e tabulações dentro de aspas, então um export reimportado é byte-fiel — chaves PEM e tokens com CRLF sobrevivem à ida e volta. - O formato Docker não representa quebras de linha: se algum valor for multilinha, o servidor recusa a exportação nomeando as chaves, em vez de emitir um arquivo quebrado. Use
.envouJSONnesses casos.
Limites
| Limite | Valor |
|---|---|
| Chaves por gravação em lote | 1000 — a CLI fatia arquivos maiores automaticamente |
| Tamanho de cada valor | 64 KiB |
| Comentário por chave | 500 caracteres |
| Conteúdo de importação | 1 MiB |
| Ambientes na criação do projeto | 20, com nomes de até 40 caracteres |
- Comentários na gravação em lote: uma chave sem comentário novo mantém o comentário armazenado; um comentário idêntico ao armazenado conta como igual (reenviar o mesmo formulário não gera versão); uma string vazia limpa o comentário.