Maven依赖范围与管理-优快云博客

本文链接：https://blog.youkuaiyun.com/bugnotfound/article/details/146514061

Maven

依赖范围

1. compile (默认范围)

作用范围：编译、测试、运行时都有效

特点：

如果没有指定 scope，默认就是 compile

会打包到最终的构建结果中

会传递到依赖的项目中

示例：

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

2. provided

作用范围：编译和测试时有效，运行时由容器提供

特点：

不会打包到最终的构建结果中

不会传递到依赖的项目中

常用于 Servlet API、JSP API 等由容器提供的依赖

示例：

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

3. runtime

作用范围：测试和运行时有效，编译时无效

特点：

会打包到最终的构建结果中

会传递到依赖的项目中

常用于 JDBC 驱动等编译时不需要但在运行时需要的依赖

示例：

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

4. test

作用范围：仅测试时有效

特点：

不会打包到最终的构建结果中

不会传递到依赖的项目中

仅用于测试代码的编译和执行

示例：

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

5. system

作用范围：类似于 provided，但需要显式指定本地系统路径

特点：

不推荐使用，因为会导致构建不可移植

需要配合 <systemPath> 元素使用

不会从 Maven 仓库查找，而是使用本地文件系统中的 JAR

示例：

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

6. import (仅适用于 `<dependencyManagement>` 部分)

作用范围：用于导入其他 POM 中的依赖管理部分

特点：

不会实际引入依赖

仅用于继承其他 POM 的 <dependencyManagement> 部分

类型必须为 pom

示例：

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.example</groupId>
      <artifactId>parent-pom</artifactId>
      <version>1.0.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

依赖管理

<dependency>（单个依赖项）
作用：声明一个具体的依赖项（JAR 包或其他模块）。

位置：通常嵌套在 <dependencies> 标签内。

特点：

直接引入依赖，默认会被项目继承并实际使用。

需要指定 groupId、artifactId 和 version（除非在 <dependencyManagement> 中已定义）。

示例：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
    <version>5.3.10</version>
</dependency>

<dependencies>（依赖集合）
作用：包裹一组，声明项目直接使用的依赖列表。

特点：

这里声明的依赖会实际下载到项目中（编译、运行或测试时使用）。

子模块会继承父 POM 中 <dependencies> 的所有依赖（除非使用 <optional>true</optional>）。

示例：

<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>5.3.10</version>
    </dependency>
</dependencies>

<dependencyManagement>（依赖管理）
作用：统一管理依赖的版本和范围，但不直接引入依赖。

特点：

子模块可以继承父 POM 中 <dependencyManagement> 的配置，但子模块仍需显式声明依赖（无需写 version 或 scope，会自动继承）。

适合多模块项目中集中管理版本号，避免版本冲突。

如果子模块不声明依赖，则不会实际引入该依赖。

示例（父 POM）：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>5.3.10</version> <!-- 统一版本 -->
        </dependency>
    </dependencies>
</dependencyManagement>

子模块引用时（无需写 version）：

<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId> <!-- 版本从父POM继承 -->
    </dependency>
</dependencies>