Java Maven依赖案例如何引入

本文目录导读：

1. 基础案例：引入一个外部库
2. 典型案例：单元测试（JUnit）
3. 常见特殊情况处理
4. 快速速查表：常见依赖坐标

在Java Maven项目中引入依赖，核心是通过在 pom.xml 文件中添加 <dependency> 标签来实现。

以下是一个完整的引入案例,包含常见场景和操作步骤。

基础案例：引入一个外部库

假设你想在项目中使用 Google 的 Gson 库来处理 JSON。

第一步：搜索依赖坐标

前往 Maven中央仓库 搜索 gson，找到最新且稳定版本（10.1），你会看到类似这样的信息：

<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.10.1</version>
</dependency>

第二步：添加到 pom.xml

找到 pom.xml 文件，将上述代码放入 <dependencies> 标签内。

<project ...>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>my-demo</artifactId>
    <version>1.0.0</version>
    <!-- 引入依赖的地方 -->
    <dependencies>
        <!-- Gson 依赖 -->
        <dependency>
            <groupId>com.google.code.gson</groupId>
            <artifactId>gson</artifactId>
            <version>2.10.1</version>
        </dependency>
    </dependencies>
</project>

第三步：刷新项目（IDEA）或运行命令

• IntelliJ IDEA：点击右侧 Maven 窗口的 刷新 按钮，或按 Ctrl + Shift + O。
• Eclipse：右键项目 -> Maven -> Update Project。
• 命令行：在项目根目录运行 mvn clean install。

成功后，你就可以在代码中使用了：

import com.google.gson.Gson;
public class Main {
    public static void main(String[] args) {
        Gson gson = new Gson();
        System.out.println(gson.toJson("Hello Maven!"));
    }
}

典型案例：单元测试（JUnit）

测试框架几乎每个项目都会用到,且通常不需要指定 <scope>，因为它默认是 compile（所有阶段可用），但最好指定 test 范围，避免将测试库打包到最终产品中。

<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter</artifactId>
    <version>5.10.0</version>
    <scope>test</scope> <!-- 只在测试时使用 -->
</dependency>

常见特殊情况处理

1 引入本地 JAR 包 (不推荐，但有时必须)

如果依赖不在中央仓库,可以通过 system 范围引入：

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

注意：这种方式会破坏可移植性，优先推荐将 JAR 安装到本地仓库或私有仓库。

2 排除传递性依赖 (避免冲突)

当 A 库依赖了 B 库的某个冲突版本时，你可以排除它：

<dependency>
    <groupId>com.example</groupId>
    <artifactId>library-a</artifactId>
    <version>1.0</version>
    <exclusions>
        <!-- 排除 library-a 中可能引入的旧版 slf4j -->
        <exclusion>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-simple</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3 使用属性统一管理版本 (最佳实践)

当多个依赖使用相同版本（如 Spring Boot、Jackson 等）时，用属性可以避免手动到处修改：

<properties>
    <spring.version>5.3.30</spring.version>
</properties>
<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>${spring.version}</version>
    </dependency>
</dependencies>

快速速查表：常见依赖坐标

1. 查找：去 Maven 中央仓库搜索。
2. 复制：将 <dependency> 代码复制到 pom.xml 的 <dependencies> 里。
3. 刷新：让 IDEA/Maven 下载 JAR 包。
4. 使用：在 Java 代码中 import 对应类。

如果你是想引入某个特定库（Alibaba 的 EasyExcel、Apache POI 等），或者遇到了依赖冲突问题，可以告诉我更具体的场景，我可以帮你贴出对应的完整 pom.xml 配置和冲突解决方案。