TAREFAGuide

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. 1

    Na matriz do projeto, clique em `Importar variáveis`.

    O assistente abre em duas etapas.

  2. 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. 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, muda ou igual, além dos avisos do parser, e permite excluir linhas. Nada é gravado nesta etapa.

  4. 4

    Clique em `Importar N chave(s)`.

    resultado
    As 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 .env escapa 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 .env ou JSON nesses casos.

Limites

LimiteValor
Chaves por gravação em lote1000 — a CLI fatia arquivos maiores automaticamente
Tamanho de cada valor64 KiB
Comentário por chave500 caracteres
Conteúdo de importação1 MiB
Ambientes na criação do projeto20, 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.

Próximo