在IntelliJ IDEA项目中添加外部JAR文件 | Baeldung

1. 概述

IntelliJ IDEA 是 Java 开发中广泛使用的 IDE，提供免费和付费版本。在 Java 项目中，JAR 文件包含可复用的代码和资源，方便引入外部库。

在 IntelliJ IDEA 中使用 Apache POI 或 JDBC 驱动等工具时，必须将 JAR 文件添加到 classpath。这能让项目在编码和运行时正确识别这些库。

本文将详细介绍在 IntelliJ IDEA 项目中添加外部 JAR 文件的步骤。

2. 为什么要在 IntelliJ IDEA 中添加外部 JAR 文件？

添加外部 JAR 文件让我们能使用第三方库。这些库提供了 Java 默认未包含的额外功能，例如：

• Apache Commons Collections 提供高级数据结构
• Jackson 处理 JSON 数据
• MySQL Connector 实现数据库连接

通过添加 JAR 文件，我们无需手动编写代码即可使用这些功能。这对集成外部 API、框架和工具至关重要。IntelliJ IDEA 确保项目能识别这些文件，避免运行时错误。

3. 在 IntelliJ IDEA 项目中添加外部 JAR 文件

添加外部 JAR 文件前，需先下载它。可通过 Maven Repository 或库的官网获取。搜索所需库并下载 JAR 文件。

下载后，创建名为 baeldung 的新 IntelliJ 项目：

然后按以下步骤操作：

1. 点击顶部菜单 File → Project Structure
   

2. 在左侧面板选择 Modules → 选中当前模块 → 切换到 Dependencies 标签页
   

3. 点击 + 按钮 → 选择 JARs or Directories
   

4. 定位并选中下载的 JAR 文件（本例为 commons-collections4-4.5.0-M3.jar）
   

5. 点击 OK 完成添加

✅ 验证是否成功：在项目视图的 External Libraries 部分展开，若能看到该 JAR 文件即表示添加成功

添加成功后，即可在代码中使用该 JAR 提供的所有类和方法。

3.1. 使用外部 JAR 文件创建简单 Java 程序

下面用 commons-collections4 库演示 MultiValuedMap 的功能（支持单键多值存储）。

首先导入所需类：

import org.apache.commons.collections4.MultiValuedMap;
import org.apache.commons.collections4.multimap.ArrayListValuedHashMap;

编写测试用例验证多值映射功能：

@Test
void givenMultiValuedMap_whenAddingEntries_thenCanRetrieveThem() {
    MultiValuedMap<Integer, String> authorMap = new ArrayListValuedHashMap<>();

    // 为单个作者 ID 添加多个名称
    authorMap.put(101, "Anees Asghar");
    authorMap.put(101, "A.A.");
    authorMap.put(102, "John Smith");
    authorMap.put(102, "J.S.");

    // 验证作者 ID 101 的值
    Collection<String> names101 = authorMap.get(101);
    assertEquals(2, names101.size());
    assertTrue(names101.contains("Anees Asghar"));
    assertTrue(names101.contains("A.A."));

    // 验证作者 ID 102 的值
    Collection<String> names102 = authorMap.get(102);
    assertEquals(2, names102.size());
    assertTrue(names102.contains("John Smith"));
    assertTrue(names102.contains("J.S."));

    // 验证不存在的作者 ID 返回空集合
    assertTrue(authorMap.get(103).isEmpty());
}

代码逻辑：

1. 初始化 ArrayListValuedHashMap
2. 为两个作者 ID（101 和 102）添加多个名称
3. 验证每个 ID 映射的名称数量和内容正确
4. 检查不存在的 ID（103）返回空集合

⚠️ 踩坑提醒：如果 JAR 未正确添加，IntelliJ 会报错“Cannot resolve symbol commons”：

当 IntelliJ 能识别 commons-collections4 JAR 时，程序才能正常编译运行。

4. 总结

本文介绍了在 IntelliJ IDEA 项目中添加外部 JAR 文件的完整流程：

核心步骤：通过 Project Structure → Modules → Dependencies 添加 JAR 到 classpath，并在项目视图的 External Libraries 中验证添加结果。

添加外部 JAR 文件的价值：

• 使用 Java 默认未提供的第三方库功能
• 集成数据库连接器、日志系统等工具
• 提升项目功能性和开发效率

对于有经验的开发者来说，掌握这个基础操作能快速引入外部依赖，避免重复造轮子。