Java 命令列工具深度解析：從基礎參數到 JVM 調優實戰

前言

即使在現代整合開發環境（IDE）普及的今天，java 命令依然是 Java 開發者必須掌握的核心技能，也是 SCJP（現 OCP）認證考試的重點內容。熟練掌握命令列參數，不僅有助於理解程式執行機制，更是進行 JVM 效能調優、排查線上問題的基礎。

一、標準選項速查

執行 java -help 可獲得標準用法概覽：

Usage: java [-options] class [args...]
       java [-options] -jar jarfile [args...]

核心參數分類如下：

1. 執行模式選擇

• -client：啟動 Client VM，啟動快、佔用記憶體少，適合桌面應用或開發測試（預設值）。
• -server：啟動 Server VM，啟動較慢但長期執行效能更強，適合生產環境伺服器應用。
• -hotspot：Client VM 同義詞（已棄用）。

2. 類別路徑與系統屬性

• -cp / -classpath <path>：指定類別搜尋路徑，多路徑以分號（Windows）或冒號分隔。
• -D<name>=<value>：設定系統屬性，程式中可透過 System.getProperty() 讀取。

3. 診斷與資訊輸出

• -verbose[:class|gc|jni]：啟用詳細輸出，分別監控類別載入、垃圾回收、JNI 呼叫。
• -version / -showversion：輸出版本資訊並退出 / 繼續執行。
• -version:<value>：要求特定版本執行。

4. 斷言控制

• -ea / -enableassertions[:<package>...|:<class>]：啟用斷言。
• -da / -disableassertions[:<package>...|:<class>]：停用斷言。
• -esa / -enablesystemassertions、-dsa / -disablesystemassertions：控制系統類別斷言。

5. 代理與工具介面

• -agentlib:<libname>[=<options>]：載入原生代理庫（如 -agentlib:hprof、-agentlib:jdwp=help）。
• -agentpath:<pathname>[=<options>]：以完整路徑載入原生代理庫。
• -javaagent:<jarpath>[=<options>]：載入 Java 語言代理（參考 java.lang.instrument）。

二、非標準選項 (-X) —— JVM 調優核心

執行 java -X 可查看非標準選項，這些參數常用於記憶體管理、GC 行為控制與效能分析：

1. 執行模式

• -Xmixed：混合模式（預設），熱點程式碼編譯為機器碼。
• -Xint：純解釋執行，不編譯，僅供除錯。

2. 類別路徑進階控制

• -Xbootclasspath:<path>：設定 Bootstrap 類別搜尋路徑。
• -Xbootclasspath/a:<path>：附加至 Bootstrap 路徑末尾。
• -Xbootclasspath/p:<path>：前置至 Bootstrap 路徑最前。

3. 記憶體與 GC 核心參數

• -Xms<size>：初始堆大小（如 -Xms512m）。
• -Xmx<size>：最大堆大小（如 -Xmx2g）。建議生產環境設定相同值避免震盪。
• -Xss<size>：執行緒堆疊大小（預設 512k~1M）。
• -Xnoclassgc：停用類別垃圾回收。
• -Xincgc：啟用增量 GC（已淘汰，現代 GC 演算法更優）。
• -Xloggc:<file>：將 GC 日誌含時間戳記輸出至檔案，生產環境必備。

4. 其他實用參數

• -Xbatch：停用背景編譯，強制前景編譯，利於效能測試一致性。
• -Xprof：輸出 CPU 分析資料。
• -Xfuture：啟用最嚴格檢查，預演未來預設行為。
• -Xrs：減少 JVM 使用作業系統訊號。
• -Xcheck:jni：對 JNI 函式執行額外檢查。
• -Xshare:off|auto|on：控制類別資料共享（CDS）行為。

三、實戰案例演示

1. 無參數直接執行

預設搜尋當前目錄下的類別檔案，需包含 public static void main(String[]) 的主類別。

2. 類別路徑實戰

專案結構：

myproject/
├── com/
│   └── lavasoft/
│       └── TestMainVar.class

執行命令：

C:\myproject> java -cp . com.lavasoft.TestMainVar arg1 arg2

關鍵點：-cp . 指定根目錄，主類別使用完整包名。

3. 系統屬性注入 (-D)

程式碼範例：

package com.lavasoft;
import java.util.Properties;

public class TestProperty {
    public static void main(String[] args) {
        Properties prop = System.getProperties();
        prop.list(System.out);
    }
}

執行：

java -DmyProp=999999999 -cp . com.lavasoft.TestProperty

注意：-D 參數中間不可有空格。程式即可透過 System.getProperty("myProp") 取得值。

package com.lavasoft;

public class TestMainVar {
    public static void main(String[] args) {
        System.out.println("入參列表如下：");
        for (String arg : args) {
            System.out.println(arg);
        }
    }
}

java -cp . com.lavasoft.TestMainVar hello world "param with space"