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

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

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

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

如果您完全不熟悉 Maven，可以阅读 [Maven 入门指南](https://maven.apache.org/guides/getting-started/index.html)，了解 POM、构建生命周期和目标等基本概念。

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

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

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

* 依赖 ：Maven 管理对其他项目或库的依赖项，确保使用正确的版本。

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

## 检查前提条件

对于本教程，请确保具备以下条件：

* 您熟悉 IDE，并拥有 [最新稳定版本](https://www.jetbrains.com.cn/idea/download)。 本教程将使用 IntelliJ IDEA 版本 2025.1。

* 默认情况下， Maven 插件 [已安装](managing-plugins.html)，并已在 IntelliJ IDEA 中启用。 如果不是，请检查 IDE [设置](settings-required-plugins.html)。 ![插件设置对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/settings_maven_plugins.png)

* 您有一个现有 Java 项目，并且可以在 IDE 中打开它。 如果手边没有项目，可以使用 [我们的示例项目](https://github.com/JetBrains/MortgageCalculator)，或完成 [创建您的第一个 Java 应用程序](creating-and-running-your-first-java-application.html) 教程来创建自己的 Java 示例项目。

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

## 添加 Maven 支持

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

Procedure: 添加 POM 文件

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

2. 在   项目   工具窗口中 (按 `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) 打开)，选择要添加 Maven 的模块或项目目录。 在本例中，它是   MortgageCalculator   目录。

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

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

![新建文件对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/new_pom_file.png)

4. IntelliJ IDEA检测到 Maven 构建脚本，并显示通知建议加载 Maven 项目。 点击   加载 Maven 项目  。

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

![Maven 项目视图](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_support_generated_architecture.png)

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

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

![Maven 工具窗口](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_structure.png)

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

打开已创建的  `pom.xml`  文件，并在编辑器中添加基本的 Maven [项目信息](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html)。

Procedure: 描述项目

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

```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 更改”](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven.images.expui.build.mavenLoadChanges.svg) 图标，提示同步更改。 点击该图标以同步项目。

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

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

![Maven 工具窗口：插件](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_plugins_section.png)

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

## 使用 Maven 开发

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

Procedure: 创建可执行 JAR

1. 从主菜单中选择  `构建 | 构建项目` （ ![“构建项目”图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.toolwindows.toolWindowBuild.svg)）以构建项目。 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   文件中：

```XML
<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 更改”](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven.images.expui.build.mavenLoadChanges.svg) 图标以同步更改。

这段代码足以生成一个  `.jar`  可执行文件。 如需了解 [Manifest 文件](https://maven.apache.org/shared/maven-archiver/examples/manifestFile.html) 的更多详细信息，可以查看 Maven 文档。

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

> **Note:**
> 请注意，可以执行  `package`  而不是  `install`  命令来实现相同结果。

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

![生成的 JAR](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_jar_file.png)

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

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

![运行工具窗口：结果](https://resources.jetbrains.com.cn/help/img/idea/2026.3/mortgage_calculator_run.png)

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

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

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

现在可以挑战自己，尝试添加 [父 POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html)，或尝试 [Maven 部署](https://maven.apache.org/plugins/maven-deploy-plugin/)。

