Eclipse 專案根目錄下的 .classpath 檔案定義了 Java 建置路徑配置。本文詳細解析各類 classpathentry 元素的屬性含義與對應關係。
| kind 值 | 用途 | 關鍵屬性 | 對應 UI 位置 |
|---|---|---|---|
con | 容器型條目 (JRE 等) | path="org.eclipse.jdt.launching.JRE_CONTAINER" | Libraries → JRE System Library |
src | 原始碼資料夾 | path (來源路徑), output (編譯輸出路徑, 可選) | Source 頁籤 |
output | 預設編譯輸出路徑 | path (輸出資料夾) | Source → Default output folder |
lib | 函式庫檔案 (JAR/ZIP) | path (絕對/相對路徑, 含檔名) | Libraries → Add JARs/External JARs |
var | 變數綁定函式庫 | path (含變數如 JUNIT_HOME), sourcepath (原始碼附件路徑) | Libraries → Add Variable |
<classpathentry exported="true" kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/>
<classpathentry kind="src" output="km230/apitest/classes" path="km230/apitest/src"/>
output 指定該來源資料夾編譯後 .class 檔輸出位置;若省略則使用專案預設輸出路徑。
<classpathentry kind="src" path="km230batch/src"/>
<classpathentry kind="output" path="km230server/approot/WEB-INF/classes"/>
⚠️ 整個 .classpath 中 kind="output" 僅能出現一次。
<classpathentry kind="lib" path="km230/lib/Notes.jar"/>
路徑必須包含檔名,支援 JAR/ZIP 格式。
<classpathentry kind="var" path="JUNIT_HOME/junit.jar"
sourcepath="ECLIPSE_HOME/plugins/org.eclipse.jdt.source_3.0.0/src/org.junit_3.8.1/junitsrc.zip"/>
path 使用 Classpath Variables (Preferences → Java → Build Path → Classpath Variables) 中定義的變數,sourcepath 關聯原始碼附件以便除錯檢視。
.classpath 納入版控,但需統一 Classpath Variables 定義lib 條目中使用絕對路徑,優先使用相對路徑或變數綁定sourcepath) 能大幅提升除錯體驗,建議為核心第三方庫配置