項目中往往需要一次性編譯分散在不同包路徑下的多個 Java 文件。IDE 一鍵構建雖方便，但在無圖形界面的服務器、CI/CD 流水線、或需精確控制編譯範圍時，掌握 javac 命令行批量編譯技巧至關重要。
project/ ├── src/ # 源碼根目錄 │ └── com/ │ └── test/ │ └── Test.java # 待編譯文件 ├── lib/ # 依賴 JAR 包目錄 │ ├── jxl.jar │ └── mysql.jar ├── bin/ # 編譯輸出目錄 (-d 參數指定) └── sourcelist.txt # 源文件路徑列表文件
將需編譯的 Java 文件 相對於 src 目錄的路徑，每行一個寫入文件：
com/test/Test.java com/test/Other.java com/another/PackageClass.java
關鍵點：
/ (跨平台兼容)src/ 前綴，由 -sourcepath src 指定根路徑# 在 project 目錄下執行 javac -classpath lib/jxl.jar:lib/mysql.jar -sourcepath src @sourcelist.txt -d bin
| 參數 | 含義 | 示例值 |
|---|---|---|
-classpath / -cp | 依賴庫搜索路徑 (多路徑用 : 分隔，Windows 用 ;) | lib/jxl.jar:lib/mysql.jar |
-sourcepath | 源文件根目錄，編譯器由此查找 @ 文件中的相對路徑 | src |
@sourcelist.txt | 讀取文件內每行作為編譯單元 (核心批量機制) | @sourcelist.txt |
-d bin | 輸出目錄，編譯後 .class 文件按包結構生成於此 | bin |
@echo off
echo 正在編譯 Java 源文件...
javac -classpath lib/jxl.jar;lib/mysql.jar -sourcepath src @sourcelist.txt -d bin
if %errorlevel% neq 0 (
echo 編譯失敗！
pause
exit /b 1
)
echo 編譯成功！輸出目錄: bin
pause
#!/bin/bash
echo "正在編譯 Java 源文件..."
javac -classpath lib/jxl.jar:lib/mysql.jar -sourcepath src @sourcelist.txt -d bin
if [ $? -ne 0 ]; then
echo "編譯失敗！"
exit 1
fi
echo "編譯成功！輸出目錄: bin"
javac 的編譯單元本質是單個 .java 文件。@filename 語法讓編譯器讀取文件內每一行路徑，將其作為獨立編譯單元註冊。這實現了：
-sourcepath 根路徑開始查找 @ 文件中指定的相對路徑import 依賴時，優先在 -sourcepath 下查找源碼編譯-classpath 查找已編譯的 .class 或 .jarsourcelist.txt，納入 Git 管理scripts/ 目錄，CI/CD 直接調用lib/，避免路徑硬編碼bin/ 或 target/classes/ 加入 .gitignore| 錯誤現象 | 可能原因 | 解決方案 |
|---|---|---|
| 找不到符號 | 依賴類未在 classpath/sourcepath 中 | 補全 lib/ 或源碼路徑 |
| 包不存在 | sourcepath 指向錯誤或文件路徑寫錯 | 檢查 src 目錄結構與列表文件路徑對應 |
| 編碼錯誤 | 源文件非 UTF-8 編碼 | 添加 -encoding UTF-8 參數 |
| 版本不兼容 | JDK 編譯版本與運行版本不匹配 | 指定 -source 1.8 -target 1.8 |
javac @sourcelist.txt 方案以 極簡依賴、零框架侵入、跨平台通用 的特點，成為輕量級 Java 項目、教學演示、舊系統維護、容器化構建場景下的理想選擇。理解其背後的「編譯單元註冊」機制，有助於深入掌握 Java 編譯原理，並在無法使用構建工具時游刃有餘。
