Maven 依賴范圍（Scope）詳解

Maven 是一個強大的項目管理工具，廣泛用于 Java 開發中構建、管理和部署應用程序。在使用 Maven 構建項目時，我們經常需要引入各種第三方庫或框架作為項目的依賴項。通過在 pom.xml 文件中的 <dependencies> 部分定義這些依賴。每個依賴可以指定一個范圍（scope），用來控制該依賴如何被使用以及它會在哪些類路徑中可見。

1. 默認范圍（compile）

這是 Maven 中默認的依賴范圍，如果沒有明確指定范圍，默認情況下就是 compile 范圍。

<dependency><groupId>org.apache.commons</groupId><artifactId>commons-lang3</artifactId><version>3.9</version>
</dependency>

特點：

• 編譯、測試和運行時類路徑都會包含該依賴。
• 打包時也會將此依賴打包進最終的 JAR 或 WAR 文件中。

2. 運行范圍（runtime）

runtime 范圍用于指定那些僅在運行時需要，而在編譯時不需要的依賴。例如，JDBC 驅動程序通常用這種范圍來定義。

<dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.21</version><scope>runtime</scope>
</dependency>

特點：

• 編譯時類路徑不包含此依賴。
• 測試和運行時的類路徑會包含該依賴。
• 打包時，這些依賴會被打包進最終的 JAR 或 WAR 文件中。

3. 提供范圍（provided）

provided 范圍用于指定那些在編譯和測試時需要，但是在運行時由容器或環境提供的依賴。例如，在使用 Servlet 容器如 Tomcat 進行開發時，Servlet API 可以用這種范圍來定義。

<dependency><groupId>javax.servlet</groupId><artifactId>javax.servlet-api</artifactId><version>4.0.1</version><scope>provided</scope>
</dependency>

特點：

• 編譯和測試時類路徑包含此依賴。
• 運行時類路徑不包含，假設運行環境會提供這些類。

4. 測試范圍（test）

test 范圍用于指定那些僅在編譯和執行測試時需要的依賴。例如 JUnit 等測試框架通常用這種范圍來定義。

<dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.13.2</version><scope>test</scope>
</dependency>

特點：

• 僅編譯和運行測試時類路徑包含此依賴。
• 編譯和運行主程序時不包括。

5. 系統范圍（system）

system 范圍允許你引用一個不在 Maven 存儲庫中的依賴。這種依賴必須由 systemPath 元素明確指定其位置。

<dependency><groupId>com.oracle</groupId><artifactId>ojdbc6</artifactId><version>11.2.0.3</version><scope>system</scope><systemPath>${project.basedir}/lib/ojdbc6.jar</systemPath>
</dependency>

特點：

• 類似于 provided 范圍，但在編譯和測試時需要指定具體的文件路徑。
• 這種依賴不在 Maven 中央倉庫中查找。

6. 導入范圍（import）

import 范圍用于在 <dependencyManagement> 部分引用 BOM (Bill of Materials) 文件。這允許你管理整個項目的依賴版本和范圍，而不必在每個子模塊的 pom.xml 中重復這些信息。

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-dependencies</artifactId><version>2.3.4.RELEASE</version><type>pom</type><scope>import</scope>
</dependency>

特點：

• 僅在 <dependencyManagement> 中使用。
• 可以幫助管理所有子模塊的依賴。

通過合理地選擇和配置 Maven 的依賴范圍，可以更好地控制項目的構建過程，避免不必要的類路徑污染，并確保項目能在正確的環境和條件下運行。