Java 取得系統屬性與環境變數完整指南：System.getProperties、getenv、常用鍵值對照表

Java 提供兩大標準途徑存取執行環境資訊：System.getProperties() (JVM 系統屬性) 與 System.getenv() (作業系統環境變數)。本文完整列出遍歷程式碼、常用鍵值含義對照表、存取最佳實務與跨平台注意事項。

1. 系統屬性

Properties props = System.getProperties();
for (Map.Entry entry : props.entrySet()) {
    System.out.println(entry.getKey() + " --> " + entry.getValue());
}

// 取單一屬性
String javaHome = System.getProperty("java.home");
String osName = System.getProperty("os.name");
String userDir = System.getProperty("user.dir");

常用系統屬性對照表

2. 環境變數

Map env = System.getenv();
for (Map.Entry entry : env.entrySet()) {
    System.out.println(entry.getKey() + " --> " + entry.getValue());
}

// 取單一變數 (Java 5+)
String path = System.getenv("PATH");
String javaHomeEnv = System.getenv("JAVA_HOME");

常見環境變數對照表

3. 系統屬性 vs 環境變數：差異與選擇

4. 最佳實務

• 配置外部化：啟動腳本用 -Dapp.config=/etc/app/config.yml 傳入，程式碼 System.getProperty("app.config") 讀取。
• 編碼明確化：啟動加 -Dfile.encoding=UTF-8，避免平台預設編碼差異導致中文亂碼。
• 路徑用 File.separator：String path = System.getProperty("user.home") + File.separator + ".myapp"。
• 環境變數作為覆蓋層：String val = System.getProperty("key", System.getenv("KEY")) (Java 8+ getProperty 無預設值多載，需自行判斷)。
• 安全性：勿在日誌輸出完整 System.getProperties()，可能洩露 java.class.path 內含密鑰路徑等敏感資訊。

5. 完整示例：環境診斷工具類

public final class EnvDiagnostics {
    public static void printSummary() {
        System.out.println("=== JVM System Properties ===");
        printProps(System.getProperties(), Arrays.asList(
            "java.version", "java.home", "java.class.path", "java.library.path",
            "os.name", "os.arch", "os.version",
            "user.name", "user.home", "user.dir",
            "file.encoding", "file.separator", "path.separator", "line.separator"
        ));

        System.out.println("\n=== OS Environment Variables ===");
        printProps(System.getenv(), Arrays.asList(
            "PATH", "JAVA_HOME", "CLASSPATH", "TEMP", "TMP",
            "USERPROFILE", "HOME", "LANG", "LC_ALL"
        ));
    }

    private static void printProps(Map props, Collection keys) {
        for (Object k : keys) {
            Object v = props.get(k);
            System.out.printf("%-30s --> %s%n", k, v != null ? v : "");
        }
    }
}

掌握上述 API 與鍵值對照，即能快速診斷部署環境、編寫跨平台相容的路徑與配置邏輯。

1. 上一篇文章： Java 中文數字混排字串自然排序：正則提取數字組、Comparable 實作與單元測試完整範例
2. 下一篇文章： C++ 裸指標 vs unique_ptr vs shared_ptr 效能實測：300 萬次佇列操作、自訂 new/delete 統計、移動語義優化

更多程式設計知識

Python 多重繼承與 Mixin 模式深度解析：組合優於繼承

Python 支援多重繼承，配合 Mixin 模式能以組合方

Python 線程編程完全指南：基礎模型、同步原語與 threading 模塊深度解析

1. 線程基礎模型 1.1 五大狀態與轉換 線程生命周期：新

Python 條件判斷完整教學：if、else、elif 與巢狀結構

if-else 語法 if expression:

VC++ DLL 程式設計：動態連結庫偵錯與導出函數檢視技巧

DLL 無法獨立執行，偵錯時需載入呼叫端 EXE。本文介紹