llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

为现有 Java 项目添加 Maven 支持。前一句为误生成,请忽略。

在本教程中,您将了解如何向现有 IntelliJ IDEA 项目添加 Maven 支持,并使用 Maven 构建它。

Maven 是一种构建自动化和项目管理工具,主要用于 Java。 本教程将使用一个简单的 Java 项目。

如果您完全不熟悉 Maven,可以阅读 Maven 入门指南 ,了解 POM、构建生命周期和目标等基本概念。

不过,先快速了解一下本教程将引用的以下概念:

  • 项目对象模型 (POM) :一个 XML 文件 (pom.xml),用于描述项目,包括其构建配置和其他项目信息。

  • 构建生命周期 :Maven 定义了一套标准的构建阶段序列,这些阶段由一些任务 (目标) 组成。

  • 依赖 :Maven 管理对其他项目或库的依赖项,确保使用正确的版本。

  • 插件 :Maven 插件通过提供额外目标和任务来扩展其功能性。 它们会自动执行编译、测试、打包和部署等任务。

检查前提条件

对于本教程,请确保具备以下条件:

  • 您熟悉 IDE,并拥有 最新稳定版本。 本教程将使用 IntelliJ IDEA 版本 2025.1。

  • 默认情况下, Maven 插件 已安装 ,并已在 IntelliJ IDEA 中启用。 如果不是,请检查 IDE 设置。

    插件设置对话框
  • 您有一个现有 Java 项目,并且可以在 IDE 中打开它。

    如果手边没有项目,可以使用 我们的示例项目 ,或完成 创建您的第一个 Java 应用程序 教程来创建自己的 Java 示例项目。

  • 本教程将使用捆绑的 Maven 版本 3.9 和默认项目 JDK 版本 21.0.1。 如果使用自己的项目而不是示例,请确保 Maven 和 JDK 版本兼容。

添加 Maven 支持

我们先添加一个 pom.xml 文件。

添加 POM 文件

  1. 打开一个现有 Java 项目。

  2. 在 项目 工具窗口中 (按 Alt+1 打开),选择要添加 Maven 的模块或项目目录。 在本例中,它是 MortgageCalculator 目录。

  3. 右键点击它,并从上下文菜单中选择 新建 | 文件。

    在 新建文件 对话框中,添加 pom.xml。

    新建文件对话框
  4. IntelliJ IDEA检测到 Maven 构建脚本,并显示通知建议加载 Maven 项目。 点击 加载 Maven 项目。

    IntelliJ IDEA 会在 项目 工具窗口中生成标准 Maven 布局。

    Maven 项目视图

    IntelliJ IDEA 还会创建一个包含 生命周期 和 仓库 的相应结构,该结构位于 Maven 工具窗口中。

    Maven 工具窗口可帮助查看项目并执行构建生命周期的目标。

    Maven 工具窗口

    由于 pom.xml 文件中没有项目相关信息,IDE 也会在 项目 工具窗口和 Maven 工具窗口中高亮显示它。

打开已创建的 pom.xml 文件,并在编辑器中添加基本的 Maven 项目信息。

描述项目

  1. 在编辑器中打开 pom.xml 文件,并添加以下信息:

    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.example</groupId> <artifactId>mortgage-calculator</artifactId> <version>1.0-SNAPSHOT</version> <name>Mortgage Calculator</name> </project>

    添加的信息可帮助 Maven 识别、构建和管理项目。 让我们进一步了解一下:

    • XML 命名空间声明 会告知 Maven 和 XML 解析器如何验证和解释 POM 文件。

    • 模型版本 是正在使用的 POM 模型版本。 Maven 目前仅支持 4.0.0,但仍需要显式声明它。

    • groupId 是项目组的唯一标识符 (类似于 Java 软件包名称)。 它有助于将我们的项目与其他项目区分开来。

    • artifactId 是工件的名称 (构建 JAR 或 WAR 等输出时使用)。 Maven 会在创建或引用软件包时使用它。

    • 版本 是项目的版本。 SNAPSHOT 后缀表示它正在积极开发中,可能会频繁更改。

    • 名称 是项目的人类可读名称。

    添加信息后,IntelliJ IDEA 会显示 “同步 Maven 更改” 图标,提示同步更改。 点击该图标以同步项目。

    IntelliJ IDEA 会解析 Maven 工具窗口中的项目结构,并重新加载项目中已更改的部分。

  2. 检查 Maven 工具窗口,IntelliJ IDEA 会添加 插件 部分。

    Maven 工具窗口:插件

此时,我们已成功将普通 Java 项目转换为基于 Maven 的项目。 如果想要更改项目并进一步开发项目,应在 POM 中进行所有项目更改,因为 IntelliJ IDEA 会将 pom.xml 文件视为单一事实来源。 那么,看看还能做些什么。

使用 Maven 开发

让我们使用 Maven 进一步开发项目。 创建一个 JAR 可执行文件来结束本教程。

创建可执行 JAR

  1. 从主菜单中选择 构建 | 构建项目 (“构建项目”图标 )以构建项目。 IntelliJ IDEA 生成 target 文件夹。 请注意,IntelliJ IDEA 只会编译源代码,不会创建本教程所需的 .jar 文件或 MANIFEST.MF 文件。 先从 MANIFEST.MF 文件开始。

  2. 我们需要在 resources 目录中创建一个 Manifest 文件。

    右键点击该目录,选择 新建 | 目录 以创建 META-INF 子目录。 然后右键点击子目录,选择 新建 | 文件 创建 MANIFEST.MF 文件。

  3. 在编辑器中打开 MANIFEST.MF 文件,并添加有关您的 main class 的信息。 主类名为 MortgageCalculator ,将其添加进去。 (如果使用自己的项目,请使用其主类的名称)。

    请添加以下代码:

    Main-Class: MortgageCalculator

    或者,我们可以通过在 pom.xml 中使用以下代码,要求 Maven 将此代码行添加到 MANIFEST.MF 文件中:

    <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-jar-plugin</artifactId> <configuration> <archive> <manifest> <mainClass> MortgageCalculator </mainClass> </manifest> </archive> </configuration> </plugin> </plugins> </build>

    添加代码后,点击 “同步 Maven 更改” 图标以同步更改。

    这段代码足以生成一个 .jar 可执行文件。 如需了解 Manifest 文件 的更多详细信息,可以查看 Maven 文档。

  4. 在 Maven 工具窗口中,在 生命周期 列表中,双击 install 命令生成 .jar 文件。

    Maven 会在 target 文件夹中生成相应信息,并在 项目 工具窗口中生成一个 JAR 可执行文件。

    生成的 JAR
  5. 右键点击生成的 JAR,然后选择 运行 以执行该文件。

    可以在 运行 工具窗口中查看结果。

    运行工具窗口:结果

    已成功执行创建的 .jar 文件。

总结一下本教程中完成的内容。

我们从一个常规 Java 项目开始,通过添加 pom.xml 文件并在其中定义项目配置,将其转换为 Maven 项目。 随后构建了项目,并使用 Maven 成功创建了一个 JAR 可执行文件并运行了它。

现在可以挑战自己,尝试添加 父 POM ,或尝试 Maven 部署。

2026年 11月 3日