Node.js: Variáveis de ambiente nativas (sem dependências)


A partir da versão >= 20.6, já é possível trabalhar com variáveis de ambiente no Node.js de forma nativa, sem precisar instalar pacotes de terceiros.

Para isso, basta usar a opção –env-file.

Assumindo que você já tenha criado um arquivo .env na raíz do seu projeto, basta rodar o seguinte comando:

node --env-file=.env index.js

Pronto! Sua aplicação irá iniciar já com todas as variáveis de ambiente do arquivo .env carregadas, que como de costume, estarão disponíveis no process.env.

Variáveis em múltiplos arquivos

Se desejar, você também pode separar suas variáveis de ambiente em arquivos diferentes.

Por exemplo, nesse caso, as variáveis do .dev.env irão sobrescrever as variáveis do .env.

node --env-file=.env --env-file=.dev.env index.js

Arquivo de configuração opcional

Por padrão, a --env-file irá disparar um erro caso o arquivo informado não exista.

Caso você não queira que isso aconteça, é possível usar uma outra opção: –env-file-if-exists, introduzida no Node.js v22.9.

node --env-file-if-exists=.env index.js

O comportamento dessa opção é o mesmo da --env-file, porém, não irá disparar um erro caso o arquivo informado não exista.