Ant（Another Neat Tool）是Apache基金會旗下基於Java的構建工具，以XML聲明式構建腳本替代繁瑣的命令行操作。它不依賴IDE、跨平台、可擴展，是早期Java項目標準構建工具，雖然Maven/Gradle已成主流，但Ant仍廣泛用於舊系統維護、輕量級腳本、嵌入式構建任務。本文覆蓋安裝配置、核心概念、構建文件編寫、常用任務與最佳實踐。
| 概念 | 說明 | 類比 |
|---|---|---|
| Project | 構建項目根節點，含name、default、basedir | 整個構建腳本 |
| Target | 構建階段/目標，含任務序列，可依賴其他target（depends） | make的目標、Gradle的Task |
| Task | 原子操作單元（編譯、複製、打包、測試），對應Java類 | 命令行指令 |
| Property | 鍵值對變量，${name}引用，不可變（首次賦值生效） | 環境變量/常量 |
| Path/FileSet | 文件路徑集合，支持通配符、包含/排除模式 | 文件選擇器 |
apache-ant-1.10.14-bin.zipD:\dev\apache-ant-1.10.14JAVA_HOME=D:\dev\jdk-17ANT_HOME=D:\dev\apache-ant-1.10.14Path追加%ANT_HOME%\binant -version顯示版本信息即成功junit.jar放入%ANT_HOME%\lib，或在構建文件<classpath>引用
project-root/
├── build.xml # Ant構建文件
├── src/ # 源碼
│ └── com/example/...
├── test/ # 測試源碼
├── lib/ # 第三方JAR
├── build/ # 輸出目錄（編譯類、JAR、報告）
│ ├── classes/
│ ├── test-classes/
│ ├── dist/
│ └── reports/
| 任務 | 用途 | 關鍵屬性/子元素 |
|---|---|---|
<javac> | 編譯Java源碼 | srcdir, destdir, classpath, encoding, debug, includeantruntime |
<jar> | 創建JAR文件 | destfile, basedir, manifest, fileset |
<war> | 創建WAR文件 | destfile, webxml, classes, lib, fileset |
<copy> | 複製文件/目錄 | file/todir, fileset, flatten, overwrite |
<delete> | 刪除文件/目錄 | file/dir, fileset, includeEmptyDirs |
<mkdir> | 創建目錄 | dir |
<junit> | 運行JUnit測試 | printsummary, haltonfailure, formatter, batchtest, fork |
<junitreport> | 生成測試HTML報告 | todir, fileset, report/format |
<exec> | 執行外部命令 | executable, args, dir, outputproperty |
<property> | 定義屬性 | name, value, location, file, environment |
<path> | 定義路徑結構 | id, location, path, fileset, pathelement |
<property name="x" value="1"/>後再設value="2"無效。利用此特性實現「默認值+命令行覆蓋」：ant -Dx=2<path id="...">定義，<classpath refid="..."/>復用，避免重複depends="clean,init,compile,test,jar"構建DAG，Ant自動拓撲排序執行<junit fork="yes">隔離測試JVM，防止靜態狀態污染、類加載器衝突<javac>、<copy>（filtering）、<xmlvalidate>指定encoding="UTF-8"${basedir}、相對路徑、屬性文件<property file="build.properties"/><javac>自動檢測源/類文件時間戳，僅編譯變更類；大項目可配合<depend>任務分析類依賴| 維度 | Ant | Maven | Gradle |
|---|---|---|---|
| 配置風格 | XML聲明式（命令式） | XML聲明式（約定優於配置） | Groovy/Kotlin DSL（編程式） |
| 依賴管理 | 手動（Ivy插件可增強） | 核心優勢（中央倉庫、傳遞依賴） | 強大（Maven/Ivy兼容、豐富API） |
| 生命周期 | 自定義Target | 固定標準階段 | 可擴展Task圖 |
| 適用場景 | 舊系統、輕量腳本、非Java構建、嵌入式任務 | 標準Java項目、企業級規範化 | 複雜多模組、Android、多語言、高度定制 |
Ant以簡單、直接、可控著稱，雖無傳遞依賴管理、約定目錄結構等現代特性，但在存量系統維護、特定自動化腳本、教學演示構建原理等場景仍具不可替代價值。掌握Ant核心模型，能幫助理解Maven/Gradle底層原理，並在必要時編寫自定義Task擴展構建能力。
