# Maven

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

> **TL;DR**
> IntelliJ IDEA 支持 Maven 3.1 及更高版本。
>
>
>
> 默认捆绑的 Maven 版本为 [3.9.11](https://maven.apache.org/docs/history.html)。
>
>
>
> 从 IntelliJ IDEA 版本 2025.1 开始，可以使用 Maven 4 版本。

IntelliJ IDEA 支持与 [Maven](https://maven.apache.org) 的全功能集成，帮助您自动化构建过程。 您可以创建新的 Maven 项目，打开并同步现有项目，为任何现有的 IntelliJ IDEA 项目 [添加 Maven 支持](convert-a-regular-project-into-a-maven-project.html)，配置和管理多模块项目。

您还可以创建一个 Maven 项目，并将其存储在 WSL 环境中，或从 WSL 文件系统中打开它。 如需更多信息，请参阅 [WSL](how-to-use-wsl-development-environment-in-product.html)部分。

> **Note:**
> 如果您想使用未随 IntelliJ IDEA 捆绑的自定义 Maven 版本，您需要在本地进行 [安装](#maven2_install)。

Procedure: 创建一个新的 Maven 项目

1. 如果当前 IntelliJ IDEA 没有打开任何项目，请点击   新建项目   在欢迎屏幕上。 否则，从主菜单中选择  `文件 | 新建 | 项目` 。

![新建项目 Maven](https://resources.jetbrains.com.cn/help/img/idea/2026.3/new%20_project_maven.png)

2. 为新项目命名，并在必要时更改其位置。

3. 选择   创建 Git 仓库   将新项目置于版本控制之下。

您也可以随时在之后进行此操作。

4. 选择要在项目中使用的语言。 如果要添加通过插件提供的其他语言，请点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)。

5. 在   构建系统  列表中选择   Maven  。

6. 指定项目的 SDK (JDK)，或使用默认 SDK。

7. 所选的   添加示例代码  选项将创建一个包含基础代码示例的文件。

8. 在   高级设置   中，指定以下 [Maven 坐标](https://maven.apache.org/pom.html#Maven_Coordinates)，并将其添加到  `pom.xml`  文件中：

* GroupId ——新项目的包。

* ArtifactId ——您的项目名称。

有关更多信息，请参阅 [Maven 命名约定](https://maven.apache.org/guides/mini/guide-naming-conventions.html)。

9. 点击   创建  。

IntelliJ IDEA 会创建一个包含编译器源代码和 Java 目标版本的  `pom.xml`  文件、专用 Maven 工具窗口以及所有必要依赖项的 Maven 项目，以便您开始工作。

> **Note:**
> 指定在  `pom.xml`  文件中的 Java 版本将覆盖在   导入程序的 JDK   选项中指定的版本，该选项位于 [Maven](maven-importing.html) 设置中。

Procedure: 使用 Maven 原型创建新项目

1. 启动 IntelliJ IDEA。

在 IntelliJ IDEA 主屏幕上，点击  `新建 | 项目` 。 如果已经打开了项目，请从主菜单中选择  `文件 | 新建项目` 。

2. 从左侧选项中选择 [Maven 原型](https://maven.apache.org/guides/introduction/introduction-to-archetypes.html)。

![Maven 原型](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_archetype.png)

3. 使用右侧的选项配置您的项目：

* 名称 ：指定您的项目名称。

* 位置 ：指定您的项目位置。

* 创建 Git 仓库 : 选择 创建 Git 仓库 将新项目置于版本控制之下。 您也可以随时在之后进行此操作。 > **Note:** > `.gitignore` 文件无论如何都会生成。

* JDK ：指定项目的 SDK（JDK）或使用默认的。

* 目录 ：指定您想在项目中使用的 Maven 仓库。 [内部 Maven 目录](https://maven.apache.org/archetype/archetype-common/internal.html) 是默认的。 您也可以选择位于 `.m2` 目录中的本地仓库，或选择 [Maven 中央仓库](https://maven.apache.org/repository/)。 您也可以点击 管理目录 并添加一个自定义仓库，如果您需要的话。

* 原型 ：选择所需的 [Maven 原型](https://maven.apache.org/archetype/index.html)。 请点击 添加 指定自定义原型。

* 版本 ：版本是自动指定的。

* 附加属性 ：添加其他属性

> **Note:**
> 如果您正在使用 [Maven 原型](https://maven.apache.org/guides/introduction/introduction-to-archetypes.html)创建项目，IntelliJ IDEA 会显示 [Maven 设置](new-projects-from-scratch-maven-settings-page.html)，您可以使用这些设置来设置 Maven 主目录路径和 Maven 仓库。 此外，您可以检查原型属性。
>
>
>
> 若要稍后在项目中修改或添加原型目录，请参阅 [原型目录](archetype-catalogs.html)设置。

Procedure: 使用 Maven 作为构建工具创建 Jakarta EE 项目

1. 启动 IntelliJ IDEA。

在 IntelliJ IDEA 主屏幕上，点击  `新建 | 项目` 。 如果已经打开了项目，请从主菜单中选择  `文件 | 新建项目` 。

2. 请从生成器列表中选择   Jakarta EE  。

3. 将默认选项   Maven   保留为您的构建工具系统。

4. 选择其他库和框架。

5. 指定您的项目名称、位置和 [工件坐标](#maven_coordinates)。 点击   创建  。

IntelliJ IDEA 创建一个 Maven 项目，并在专用的   Maven  工具窗口中添加必要的依赖项。

有关更详细的信息，请参阅 [教程：您的第一个 Jakarta EE 应用程序](creating-and-running-your-first-jakarta-ee-application.html)。

Procedure: 打开一个现有的 Maven 项目

1. 前往  `文件 | 打开` 。

或者，点击   打开   以进入欢迎界面。

> **Note:**
> 如果您有一些需要从 IntelliJ IDEA 模型导入项目的自定义插件，请按 `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS)) 并搜索   从现有源创建项目   操作。

2. 在打开的对话框中，选择您要打开的项目的  `pom.xml`  文件。

点击   OK  。

3. 在打开的对话框中，点击   作为项目打开  。

IntelliJ IDEA 在 IDE 中打开并同步 Maven 项目。 如果您在打开项目时需要调整导入选项，请参阅 [Maven 设置](maven-importing.html)。 例如，如果您在  `maven/config` 文件中配置了 Maven 选项并希望在项目中使用它们，请在 Maven 设置中选择 [使用 .mvn/maven.config 中的设置](maven.html#maven_config)选项。

> **Tip:**
> 如果您有一个配置了 Maven wrapper 的 Maven 项目，那么 IntelliJ IDEA 将从  `maven.properties`  文件中获取 Maven 版本并将其添加为 Maven home 路径。

Procedure: 在打开新项目之前配置 Maven 设置

您可以配置 IntelliJ IDEA 以在打开新的 Maven 项目之前显示 Maven 设置。 （在这种情况下，一个新的 Maven 项目是指您首次在 IntelliJ IDEA 中打开的现有项目。）由于这些是应用级设置，它们会应用到您打开的任何新项目中。

1. 在欢迎屏幕上，选择  `自定义 | 所有设置` 。

或者，前往主菜单中的  `文件 | 新建项目设置 | 新项目偏好设置` 。

2. 在   设置  对话框中，选择  `构建、执行、部署 | 构建工具 | Maven` 。

3. 在   Maven  设置对话框中，选择   为新建 Maven 项目显示设置对话框  。

4. 请点击   OK   以保存更改。

下次您打开一个新项目时，IntelliJ IDEA 会显示   Maven 设置  对话框，您可以在其中指定本地 Maven 仓库的位置和用户设置文件。

![Maven 设置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_settings_new_project.png)

Procedure: 向现有项目添加新的 Maven 模块

您可以向您正在处理的项目中添加一个 Maven 模块。

1. 在   项目  工具窗口中，右键点击项目文件夹并选择  `新建 | 模块` 。 或者，请前往主菜单中的  `文件| 新建 | 模块` 以打开   新建模块  向导。

2. 如果您使用主菜单添加模块，那么添加模块的过程与 [创建一个新的 Maven 项目](#maven_create_project)相同。

如果您通过右键点击根文件夹添加子模块，那么添加新模块的过程更短。 您需要在   名称  字段中指定模块的名称。 其余信息会自动添加，您可以使用默认设置，也可以根据您的偏好设置进行更改。

Procedure: 配置多模块 Maven 项目

您可以在 IntelliJ IDEA 中创建一个 [多模块 Maven 项目](https://maven.apache.org/pom.html#Aggregation)。 由父 POM 文件和几个子模块定义的多模块项目。

> **Note:**
> 如果您安装了 Maven 3.7 或更高版本，IntelliJ IDEA 将支持从 [MNG-6656 model](https://issues.apache.org/jira/browse/MNG-6656)导入项目。
>
>
>
> 在这种情况下，当您在编辑器中打开一个子 POM 文件时，如果它位于  `relativePath` 中，您无需在  `parent` 标签中指定版本。 如果您向同一项目的模块添加依赖项，您不必指定依赖模块的版本。

1. [创建 Maven 父项目](#maven_create_project). IntelliJ IDEA 创建一个标准的 Maven 布局，包括一个  `src`  文件夹。

2. 在   项目  工具窗口中，删除  `src` 文件夹，因为您只在 [极少数情况下](https://maven.apache.org/plugins/maven-site-plugin/examples/creating-content.html)才需要它。 对于您的常规项目，您不需要父级 POM 的  `src`  文件夹。

3. 在   项目  工具窗口中，右键点击您的项目（或在主菜单中，转到   文件  ），然后选择   新建 | 模块  以添加子项目。

4. 在   新建模块   向导中，按照 [如何添加模块](#add_module_Maven) 的说明，填写必要的信息并点击   完成  。

`src`  文件夹会自动创建，您可以打开 POM 并添加所需的包装。 IntelliJ IDEA 将模块添加到父项目中。 IntelliJ IDEA 还将子项目的名称和描述添加到父 POM。

![父 POM](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_parent_pom.png)

> **Note:**
> 在一个多模块项目中，父 POM 需要具有  `pom`  打包。

最后，IntelliJ IDEA 将父 POM 的描述添加到子项目的 POM 中。

![子项目 POM](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_module_pom.png) 您可以点击左侧边距中的 ![父 POM 图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven.images.parentProject.svg) 以从您的子项目快速打开父 POM。

5. 您还可以将依赖项添加到父 POM 中，这些依赖项将被子项目继承。

![父 POM：已添加依赖](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_parent_pom_dependency.png)

6. 打开   Maven  工具窗口，以查看在父 POM 中所做的所有更改都反映在子项目中。

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

Procedure: 访问 Maven 设置

请使用 [Maven 设置](maven.html)配置 Maven 版本、本地仓库、脱机模式等选项。

1. 在   设置   对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中，转到  `构建、执行、部署| Maven` 。

> **Tip:**
> 点击 ![Maven 设置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.settings.svg) 工具栏，在   Maven   工具窗口中访问 Maven 设置。

2. 在 Maven 设置页面，配置可用选项并点击   OK   保存更改。

Procedure: 使用 Maven wrapper 或自定义版本的 Maven

> **Note:**
> Maven2 版本未与 IntelliJ IDEA 捆绑在一起。 如果需要在项目中使用，请下载并启用 [Maven2 支持](https://plugins.jetbrains.com/plugin/19663-maven2-support) 插件。
>
>
>
> 请在您的电脑上 [下载](https://archive.apache.org/dist/maven/) 所需的 Maven 版本。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `构建、执行、部署 | 构建工具 | Maven` 。

2. 在   Maven  设置页面的   Maven 主目录路径  字段中，指定 Maven 自定义版本安装的位置。 对于 Maven wrapper，请从列表中选择   使用 Maven wrapper   选项。 在这种情况下，将使用  `.mvn/wrapper/maven-wrapper.properties`  文件中定义的 Maven 版本。

![Maven 设置：Maven home 路径](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_settings_home_path.png)

3. 点击   OK  。

## 在 Maven 项目中更改 JDK 版本

有多个地方可以更改 JDK 版本，这不仅会影响您当前的项目，还会影响整个应用程序。

Procedure: 在项目结构中更改 JDK 版本

更改   项目结构   对话框中的 JDK 版本只会影响当前项目。

1. 在主菜单中，前往  `文件 | 项目结构`  `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。

2. 在打开的对话框中，在   项目SDK  ，指定 JDK 版本并点击   OK   以保存更改。

![项目结构对话框 / 项目页面](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_project_sdk.png)

Procedure: 更改 Maven 运行器的 JDK 版本

当 IntelliJ IDEA 运行 Maven 目标时，它将使用为 Maven 运行程序 指定的 JDK 版本。 默认情况下，IntelliJ IDEA 使用 [项目的 JDK](#project_structure_maven)。

更改 Maven 运行程序 的 JDK 只会影响当前项目。

1. 在   设置   对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），转到  `构建、执行、部署 | Maven | 运行器` 。

2. 在打开的 [页面](maven-runner.html)中，在   JRE  字段中选择 JDK 版本。

![Maven 设置/运行页面](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_jre.png)

Procedure: 更改 Maven 导入程序的 JDK 版本

更改 Maven 导入程序 的 JDK 版本将影响整个应用程序，因为它是 Maven 全局设置的一部分。 如果您想使用与您的项目中相同的 [JDK 版本](#project_structure_maven)来进行同步或解决依赖关系，请更改导入程序的 JDK 版本。

https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#Dependency_Scope

1. 在   设置   对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），转到  `构建、执行、部署 | Maven | 导入` 。

2. 在打开的 [页面](maven-importing.html)上，在   导入程序的 JDK  字段中，选择与您在 [项目结构](#project_structure_maven)中使用的相同JDK版本，然后点击   OK  以保存更改。

![Maven 设置/导入页面](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_jdk_importer.png)

## See also

### 过程

[为现有 Java 项目添加 Maven 支持。前一句为误生成，请忽略。](convert-a-regular-project-into-a-maven-project.html) [Maven 项目](delegate-build-and-run-actions-to-maven.html)