Maven 依赖范围
在 Maven 中，依赖范围（Scope）主要用于控制依赖在不同构建阶段（编译、测试、运行）和类路径中的可用性，以及是否参与最终的打包。
Maven 提供了 6 种依赖范围，以下是它们的核心特性、作用矩阵及典型应用场景：
1. compile（默认范围）
- 特性：全生命周期依赖。如果未显式指定
<scope>，Maven 默认使用该范围。 - 作用阶段：对主代码编译、测试代码编译、项目运行均有效。
- 打包：✅ 会包含在最终构建产物中。
- 典型场景：项目中全程需要的核心依赖，如
spring-core、log4j等。
2. test（测试专属）
- 特性：仅在测试编译和测试执行阶段有效。在主代码中无法 import 此类依赖的类，否则会报错。
- 作用阶段：❌ 主代码编译无效；✅ 测试代码编译/执行有效；❌ 运行时无效。
- 打包：❌ 不会包含在最终产物中。
- 典型场景：单元测试或集成测试框架，如
JUnit、Mockito。
3. provided（运行时由容器提供）
- 特性：编译和测试阶段需要该依赖，但运行时由 JDK 或 Web 容器（如 Tomcat）提供。
- 作用阶段：✅ 主代码编译有效；✅ 测试有效；❌ 运行时不生效。
- 打包：❌ 不会包含在构建产物中，避免与容器自带的包产生冲突。
- 典型场景：
servlet-api、lombok。
4. runtime（运行时必需）
- 特性：编译主代码时不需要（通常只需要接口），但在执行测试或运行项目时需要具体的实现类。
- 作用阶段：❌ 主代码编译无效；✅ 测试有效；✅ 运行时有效。
- 打包：✅ 会包含在构建产物中。
- 典型场景：JDBC 驱动实现（如
mysql-connector-java），因为编译时只需 JDK 提供的 JDBC 接口，运行时才需要具体的数据库驱动。
5. system（系统级本地依赖）
- 特性：与
provided类似，但不会从 Maven 仓库获取，而是从本地系统文件中获取。必须配合<systemPath>显式指定 JAR 包的绝对路径。 - 注意：实际开发中应谨慎使用，因为它破坏了项目的可移植性。如果必须使用且需要打入可执行 JAR 包，还需在 Spring Boot 等打包插件中配置
<includeSystemScope>true</includeSystemScope>。 - 典型场景：引入本地私有 SDK 或未发布到 Maven 中央仓库的旧版第三方 JAR 包。
6. import（依赖管理导入）
- 特性：它不会对三种 classpath 产生实际的物理影响，而是专门用于
<dependencyManagement>标签内。 - 用法：必须同时结合
<type>pom</type>使用，用于将另一个 POM 文件中的dependencyManagement配置导入到当前项目中，常用于统一版本控制（BOM）。
📊 核心依赖范围速查矩阵
| 依赖范围 (Scope) | 主代码编译 | 测试代码 | 运行/打包 | 典型举例 |
|---|---|---|---|---|
| compile(默认) | ✅ | ✅ | ✅ (打包) | spring-core |
| test | ❌ | ✅ | ❌ (不打包) | junit |
| provided | ✅ | ✅ | ❌ (不打包) | servlet-api |
| runtime | ❌ | ✅ | ✅ (打包) | jdbc驱动 |
| system | ✅ | ✅ | ❌ (不打包) | 本地外部JAR包 |
你之前提到的那个spring_web冲突报错，其实和依赖范围配置不当也有直接关系。需要我帮你整理一份排查步骤吗？
