As variáveis de ambiente são um conjunto de itens chave-valor em seu sistema operacional que podem ser acessadas tanto para leitura quanto para escrita. Sua aplicação pode utilizar as variáveis dependendo do ambiente de desenvolvimento, produção ou outra configuração necessária para execução.

Para listar as variáveis de ambiente em Java, utilizamos o método getenv da classe System como pode ser visto na sintaxe abaixo:

Sintaxe

Map<String, String> System.getenv();

Retorno

Map contendo chave-valor das variáveis

No exemplo abaixo, utilizamos o comando de repetição for como foreach para iterar sobre as chaves retornadas pelo método keySet do tipo Map. Os valores associados são recuperados pelo método get ao qual informamos o nome da chave.

Exemplo 1

//Main.java
import java.util.Map;

public class Main
{
	public static void main(String[] args) 
	{
        Map<String, String> vars= System.getenv();
        
        for (String _var : vars.keySet()) //set de chaves
        {
           System.out.format("%s\n\t%s\n", _var, vars.get(_var));
        } 
	}
}

Saída

DEBIAN_FRONTEND
	noninteractive
NVM_DIR
	/usr/local/nvm
LANGUAGE
	en_US:en
JAVA_HOME
	/opt/jdk/jdk-23.0.2
NODE_VERSION
	v20.16.0
LC_ALL
	en_US.UTF-8
(...)

Para recuperar apenas uma chave em específica, podemos utilizar o mesmo método getenv informando, dessa vez, o nome da chave desejada como argumento como pode ser visto na sintaxe e exemplo abaixo:

Sintaxe

System.getenv(String key)

Onde

key: string contendo nome da variável

No exemplo a seguir, utilizamos o método getenv para recuperar uma chave existente e outra inexistente. Para essa, o método irá retornar null.

Exemplo 2

//Main.java
public class Main
{
	public static void main(String[] args) 
	{
        System.out.println(System.getenv("LANGUAGE"));
        System.out.println(System.getenv("LANGUAGEX"));
	}
}

Saída

en_US:en
null

Como as variáveis de ambiente estão ligadas ao sistema operacional, essas chaves devem ser previamente configuradas para que seja possível utilizá-las no ambiente Java. Diferentes formas podem ser utilizadas para a adição de chaves no sistema operacional.

Por exemplo, no cmd do Windows, podemos configurar de forma temporária como abaixo:

Sintaxe

os.Unsetenv(key string) error

No shell do MacOs, podemos configurar como a seguir: (Verificar)

Sintaxe

os.Unsetenv(key string) error

A adição das variáveis de ambiente pode ser temporária ou permanente. A documentação do SO deve ser consultada para verificar como a adição de chave pode ser feita.

Após as devidas configurações no ambiente, os métodos vistos nos tópicos anteriores podem ser utilizados de acordo.

1. 12/08/2026 - versão inicial: listar, recuperar e adicionar