Maven 的 scope用于定义依赖项在项目构建生命周期中的可见性和传递性，控制依赖在编译、测试、运行等阶段的可用性及是否被打包到最终产物中。以下是详细解析：

⚙️ 一、Scope 的核心作用

生命周期控制
决定依赖在编译、测试、运行阶段的可用性。
依赖传递性
影响依赖是否传递给下游模块（如多模块项目）。
构建优化
避免冗余依赖，减少构建产物大小和潜在冲突。

📌 二、Scope 分类详解

1. `compile`（默认）

可用阶段：编译、测试、运行、打包
传递性：传递到下游模块。•
场景：核心业务依赖（如 Spring、Jackson）。

<dependency><groupId>org.springframework</groupId><artifactId>spring-core</artifactId><version>5.3.10</version><!-- 默认 compile，可省略 -->
</dependency>

2. `provided`

可用阶段：编译、测试，运行时由外部提供（如 Tomcat）
传递性：不传递到下游模块。
场景：容器提供的依赖（如 Servlet API）。

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

3. `runtime`

可用阶段：测试、运行，编译不可用
传递性：传递到下游模块（下游为 runtime范围）。
场景：运行时才加载的依赖（如 JDBC 驱动）。

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

4. `test`

可用阶段：仅测试（编译测试代码、运行测试）
传递性：不传递到下游模块。
场景：测试框架（如 JUnit、Mockito）。

<dependency><groupId>org.junit.jupiter</groupId><artifactId>junit-jupiter</artifactId><version>5.9.3</version><scope>test</scope>
</dependency>

5. `system`（不推荐）

可用阶段：编译、测试，需手动指定本地路径
传递性：不传递到下游模块。
风险：破坏 Maven 可移植性（依赖本地文件路径）。

<dependency><groupId>com.example</groupId><artifactId>custom-lib</artifactId><version>1.0</version><scope>system</scope><systemPath>${project.basedir}/libs/custom-lib.jar</systemPath>
</dependency>

6. `import`（仅用于 BOM 管理）

作用：在 <dependencyManagement>中导入其他 POM 的依赖配置，统一版本管理
示例：导入 Spring Boot BOM。

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

🔄 三、Scope 的传递性规则

依赖范围	传递到下游的 Scope	示例
`compile`	`compile`（下游直接依赖）	A → B（compile）→ C（compile）
`runtime`	`runtime`（下游运行时依赖）	A → B（runtime）→ C（runtime）
`test`/`provided`	不传递	下游需显式声明依赖

📌 依赖冲突解决：

就近原则：直接依赖优先级高于间接依赖。
排除依赖：用 <exclusions>移除冲突版本

<dependency><groupId>org.example</groupId><artifactId>example-lib</artifactId><exclusions><exclusion><groupId>conflict-group</groupId><artifactId>conflict-artifact</artifactId></exclusion></exclusions>
</dependency>

🛠️ 四、实际应用场景

Web 项目
- provided：Servlet API（避免与 Tomcat 内置库冲突）。
- runtime：数据库驱动（编译无需，运行需加载）
多模块项目
- 公共模块用 provided或 optional控制依赖传递，避免强制下游引入
依赖管理
- 通过 import导入 BOM，统一版本（如 Spring Cloud、JavaEE）

❓ 五、常见问题

provided vs optional
1. provided：运行环境提供，不打包。
2. optional：标记为可选，阻止传递依赖（下游可显式引入）
运行时 ClassNotFoundException
原因：provided依赖未由容器提供，或 runtime依赖未正确打包。
何时用 system
尽量避免！改用私有仓库或 mvn install安装本地依赖