CLASSPATH 環境變數深度解析與最佳配置實戰

兩種配置方式

設定類路徑有兩種主要途徑：

• 推薦：命令行參數 -classpath 或 -cp（每個應用獨立，互不干擾）
• 全域：環境變數 CLASSPATH（影響所有 Java 程式）

路徑組成規則

多路徑以分號 ; 分隔（Windows）。

JVM 類搜尋策略 (JDK 1.2+)

1. 啟動類庫：rt.jar 等核心庫
2. 擴展類庫：jre/lib/ext 目錄下的 JAR
3. 應用類路徑：-classpath 或 CLASSPATH 指定的路徑

關鍵提示：JDK 1.2 起預設類路徑為當前目錄 .。一旦手動設定 CLASSPATH 或使用 -classpath，預設值即被覆蓋，必須顯式加入 . 才能搜尋當前目錄。

包名與目錄映射鐵律

Java 要求必須指定完整包名。例如類 utility.myapp.Cool 位於 C:\Java\MyClasses\utility\myapp\Cool.class，類路徑必須設為 C:\Java\MyClasses，啟動命令：

java -classpath C:\Java\MyClasses utility.myapp.Cool

錯誤示範：設定路徑到 C:\Java\MyClasses\utility 並執行 java myapp.Cool —— JVM 找不到類，因為包名不完整。

歸檔文件與多路徑優先級

• JAR/ZIP 文件路徑直接指向檔案：java -classpath lib/app.jar com.app.Main
• 多路徑按聲明順序搜尋，先找到先使用：java -classpath dir1;dir2 ...

環境變數管理

• 臨時清除：set CLASSPATH=（僅當前會話）
• 永久修改：Windows 9x 編輯 autoexec.bat；NT 系統在「控制面板→系統→環境變數」中調整

避坑指南

• 勿將應用類放入 JDK/jre/classes 或 /classes 目錄，升級 JDK 時會丟失
• 第三方應用修改的 CLASSPATH 可保留，但建議改用啟動腳本傳參
• 理解「包分散在多目錄」特性：同一包的類可分佈在 classpath 不同路徑下