Java 獲取系統環境變量與 JVM 運行屬性完整指南

Java 獲取系統環境變量與 JVM 運行屬性完整指南

在 Java 應用開發、部署排查或跨平台適配時，經常需要讀取操作系統環境變量（如 PATH、JAVA_HOME）與JVM 系統屬性（如 java.version、user.dir）。本文提供兩種完整代碼方案：標準遍歷法與簡化單行代碼法，並附帶實際輸出示例，幫助你快速掌握核心 API。

一、核心 API 對比

二、標準遍歷代碼（推薦生產環境，可控性強）

import java.util.*;

public class SystemInfoPrinter {
    public static void main(String[] args) {
        // 1. 打印系統環境變量
        System.out.println("=== 系統環境變量 ===");
        Map<String, String> envMap = System.getenv();
        for (Map.Entry<String, String> entry : envMap.entrySet()) {
            System.out.printf("%s = %s%n", entry.getKey(), entry.getValue());
        }

        System.out.println("\n=== JVM 系統屬性 ===");
        // 2. 打印 JVM 系統屬性
        Properties props = System.getProperties();
        // 使用 Enumeration 遍歷（Properties 歷史遺留 API）
        Enumeration<?> keys = props.propertyNames();
        while (keys.hasMoreElements()) {
            String key = (String) keys.nextElement();
            System.out.printf("%s = %s%n", key, props.getProperty(key));
        }
    }
}

三、簡化單行代碼（適合調試快速查看）

// 一行打印所有系統屬性
System.getProperties().list(System.out);

// 一行打印所有環境變量（Java 8+ Lambda）
System.getenv().forEach((k, v) -> System.out.println(k + " = " + v));

四、關鍵屬性速查表

常用 JVM 系統屬性

• java.version / java.runtime.version：Java 版本號
• java.home：JRE 安裝目錄
• user.dir：當前工作目錄（相對路徑基準）
• user.home：當前用戶主目錄
• file.encoding：默認文件編碼（如 UTF-8、GBK）
• file.separator / path.separator / line.separator：跨平台路徑/路徑列表/換行符分隔符
• java.class.path：類加載路徑
• os.name / os.arch / os.version：操作系統信息

常用環境變量

• PATH：可執行文件搜索路徑
• JAVA_HOME：JDK 安裝根目錄
• CLASSPATH：舊版類路徑（現多由 -cp 或 Manifest 指定）
• TEMP/TMP：臨時文件目錄
• USERNAME/USERDOMAIN：Windows 用戶/域信息

五、實戰應用場景

1. 跨平台路徑拼接：使用 File.separator 或 Paths.get() 代替硬編碼 "/" 或 "\\"。
2. 動態配置數據庫連接：從環境變量讀取 DB_URL、DB_USER、DB_PASS，避免硬編碼敏感信息。
3. 啟動參數覆蓋：通過 -Dkey=value 設置系統屬性，如 -Denv=prod，代碼中用 System.getProperty("env") 讀取。
4. 診斷類加載問題：打印 java.class.path 確認依賴包是否生效。
5. 容器化部署：Docker/K8s 中通過 Env 注入配置，Java 應用統一用 System.getenv() 讀取。

六、注意事項

• System.getenv() 在某些受限環境（如 Applet、SecurityManager 啟用）可能返回 null 或拋出異常，建議捕獲異常處理。
• 環境變量鍵值在 Windows 上不區分大小寫，Linux/Unix 區分大小寫，跨平台代碼建議統一轉大小寫比對。
• 系統屬性可在運行期通過 System.setProperty() 修改，但環境變量不可修改（只讀）。

掌握這兩組 API，能讓你的 Java 應用更靈活地適應部署環境，也能在排查「在我機器上能跑」類問題時快速定位環境差異。