Java 獲取系統環境參數的完整指南

在 Java 應用開發中，經常需要獲取 JVM、作業系統、類路徑等運行環境資訊。Java 提供了 System.getProperties() 方法，可一次性取得所有系統屬性。本文彙整常用屬性鍵值並提供完整代碼示例，方便快速查閱。

核心 API

java.lang.System.getProperties() 返回一個 Properties 物件，繼承自 Hashtable，包含所有系統屬性鍵值對。

常用系統屬性分類表

Java 執行環境資訊

JVM 虛擬機資訊

作業系統與路徑分隔符

用戶環境資訊

完整代碼示例

import java.util.Properties;

public class SystemPropsDemo {
    public static void main(String[] args) {
        Properties props = System.getProperties();
        
        // Java 執行環境
        System.out.println("Java 版本: " + props.getProperty("java.version"));
        System.out.println("Java 廠商: " + props.getProperty("java.vendor"));
        System.out.println("Java 安裝路徑: " + props.getProperty("java.home"));
        System.out.println("類路徑: " + props.getProperty("java.class.path"));
        System.out.println("庫搜索路徑: " + props.getProperty("java.library.path"));
        System.out.println("臨時文件目錄: " + props.getProperty("java.io.tmpdir"));
        System.out.println("擴展目錄: " + props.getProperty("java.ext.dirs"));
        
        // 作業系統
        System.out.println("OS 名稱: " + props.getProperty("os.name"));
        System.out.println("OS 架構: " + props.getProperty("os.arch"));
        System.out.println("OS 版本: " + props.getProperty("os.version"));
        System.out.println("文件分隔符: " + props.getProperty("file.separator"));
        System.out.println("路徑分隔符: " + props.getProperty("path.separator"));
        System.out.println("行分隔符: " + props.getProperty("line.separator"));
        
        // 用戶環境
        System.out.println("用戶名: " + props.getProperty("user.name"));
        System.out.println("用戶主目錄: " + props.getProperty("user.home"));
        System.out.println("工作目錄: " + props.getProperty("user.dir"));
        
        // 列印所有屬性（調試用）
        // props.list(System.out);
    }
}

最佳實踐建議

• 跨平台路徑處理：使用 File.separator、File.pathSeparator 而非硬編碼分隔符
• 臨時文件：優先使用 java.io.tmpdir 獲取臨時目錄，避免權限問題
• 條件編譯邏輯：根據 os.name 判斷平台，執行平台特定代碼
• 安全考量：部分屬性（如 user.home）可能涉及隱私，日誌記錄時需脫敏

補充：獲取單個屬性

若只需特定屬性，可直接使用 System.getProperty("key")，比獲取完整 Properties 更高效：

String javaVersion = System.getProperty("java.version");
String osName = System.getProperty("os.name");

掌握系統屬性的獲取與應用，能讓你的 Java 應用更好地適應不同運行環境，提升可移植性與健壯性。