# Maven 项目

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

IntelliJ IDEA 允许您管理 [Maven](https://maven.apache.org) 项目。 您可以 [链接](#link_unlink_maven_project)、忽略项目、同步 Maven 和 IntelliJ IDEA 项目的更改，并配置构建和运行操作。

Procedure: 导航至 POM

1. 在 [Maven](maven-projects-tool-window.html) 工具窗口中，右键点击已链接的项目。

2. 在上下文菜单中，选择   跳转到源   `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS))。

IntelliJ IDEA 导航到适当的 Maven 配置文件，相关的  POM 将在编辑器中打开。

Procedure: 忽略 Maven 项目

您可以使用   忽略项目  选项停用 Maven 项目。 在这种情况下，IntelliJ IDEA 会在   Maven  工具窗口中保留忽略的 Maven 项目和子项目，但停止将其导入到项目中（模块、内容根、目标等）。 不过，IntelliJ IDEA 会将被忽略的项目与当前项目同步。 当您处理包含多个子项目且需要跳过无关子项目的项目时，这可能会有所帮助。

> **Note:**
> 如果忽略一个其他子项目依赖的项目，则被忽略的项目将变为库。 如果在 Maven 仓库中找不到这样的库，它将显示为红色。 要将此库添加到存储库中，请在   Maven  工具窗口中，打开被忽略的项目节点，并在   生命周期  中运行  `install` 命令。

1. 在 [Maven](maven-projects-tool-window.html)工具窗口中，右键点击您要忽略的项目。

2. 在上下文菜单中，选择   忽略项目  。

> **Note:**
> 或者，您可以使用   项目   工具窗口或   项目结构   对话框删除一个子项目以使其被忽略。

3. 在打开的窗口中，点击   是   如果您想从   项目   工具窗口中删除该项目。

如果您想激活您的 Maven 项目或子项目，请从上下文菜单中选择   取消忽略项目  。

Procedure: 在 Maven 设置中忽略链接项目的 POM

您可以使用   已忽略的文件   设置忽略 POM 文件。

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. 在   已忽略的文件  页面上，选择您想忽略的 POM，然后点击   OK  以保存更改。

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

3. IntelliJ IDEA 会在   Maven   工具窗口和   项目   工具窗口中显示被忽略的文件。

如果将被忽略的文件保留在   项目   工具窗口中，POM 将显示为被忽略，但仍可以在编辑器中处理并修改该文件。

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

Procedure: 同步 Maven 项目

每次您在编辑器中手动更改  `pom.xml` 文件时，您需要同步这些更改。 IntelliJ IDEA 会在编辑器右侧显示通知图标，建议   同步 Maven 更改  对项目所做的更改（ `Ctrl+Shift+O` (Windows), `Ctrl+Shift+O` (macOS), `Ctrl+Shift+O` (IntelliJ IDEA Classic (macOS)), `Ctrl+Shift+O` (macOS System Shortcuts), `Ctrl+Shift+O` (XWin), `Ctrl+Shift+O` (GNOME), `Ctrl+Shift+O` (KDE), `Ctrl+Shift+O` (Emacs), `Ctrl+Shift+O` (Sublime Text), `Ctrl+Shift+O` (Sublime Text (macOS)), `Ctrl+Shift+O` (Visual Studio), `Ctrl+Shift+O` (Visual Studio (macOS)), `Ctrl+Shift+O` (NetBeans), `Ctrl+Shift+O` (Eclipse), `Ctrl+Shift+O` (Eclipse (macOS))）。

如果您想控制项目的导入过程，可以手动触发该操作。

> **Note:**
> IntelliJ IDEA 在重新加载过程中不会解析被排除的 POM 文件的依赖性。

1. 在 [Maven](maven-projects-tool-window.html) 工具窗口中，右键点击已链接的项目。

2. 在上下文菜单中，选择   同步项目   ![同步项目图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.actions.refresh.svg)。

调用此操作时，IntelliJ IDEA 会在   Maven   工具窗口中解析项目结构。

IntelliJ IDEA 仅重新加载项目中已更改的部分。

如果您通过   项目结构  对话框( `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)))配置依赖项，该依赖项将仅出现在IntelliJ IDEA   项目  工具窗口中，而不会出现在   Maven  工具窗口中。 请注意，下次您同步项目时，IntelliJ IDEA 会移除添加的依赖项，因为 IntelliJ IDEA 将 Maven 配置视为唯一的可信来源。

Procedure: 同步或重新加载所有 Maven 项目

当您首次打开项目时，IntelliJ IDEA 会执行完整同步（重新加载）。 对项目进行更改时，可以限制作用域并仅同步必要内容，而不是为整个项目调用重新加载。

* 在 [Maven](maven-projects-tool-window.html) 工具窗口中，点击工具栏上的 ![同步/重新加载所有 Maven 项目图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.actions.refresh.svg)。

根据您想执行的同步类型，从下拉菜单中选择以下选项之一：

* 同步所有 Maven 项目 ：增量同步所有项目。 同步结果显示在 [构建工具窗口](build-sync-tool-window.html)中。 ![构建工具窗口](https://resources.jetbrains.com.cn/help/img/idea/2026.3/incremental_sync_results.png)

* 重新加载所有 Maven 项目 ：对所有 Maven 项目执行完整同步。 重新加载的结果显示在 [构建工具窗口](build-sync-tool-window.html)中。 ![重新加载项目结果](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_full_sync.png)

Procedure: 配置自动同步

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  工具窗口中，点击 ![构建工具设置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.settings.svg)并选择   自动同步设置  选项。

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

2. 在   构建工具   设置中，指定以下选项：

![构建工具设置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/build_tools_reload_settings.png)

* 在构建脚本更改后同步项目 ：默认选中此选项。 如果您想禁用自动同步并手动控制同步过程，请取消选中此复选框。

* 任何更改 ：如果您希望在对 `pom.xml` 或外部更改后自动同步项目，请选择此选项。 每次您在编辑器中手动更改 Maven 构建脚本时，您需要同步这些更改。 IntelliJ IDEA 会在编辑器右侧显示通知图标，建议 同步 Maven 更改 对项目所做的更改（ `Ctrl+Shift+O` (Windows), `Ctrl+Shift+O` (macOS), `Ctrl+Shift+O` (IntelliJ IDEA Classic (macOS)), `Ctrl+Shift+O` (macOS System Shortcuts), `Ctrl+Shift+O` (XWin), `Ctrl+Shift+O` (GNOME), `Ctrl+Shift+O` (KDE), `Ctrl+Shift+O` (Emacs), `Ctrl+Shift+O` (Sublime Text), `Ctrl+Shift+O` (Sublime Text (macOS)), `Ctrl+Shift+O` (Visual Studio), `Ctrl+Shift+O` (Visual Studio (macOS)), `Ctrl+Shift+O` (NetBeans), `Ctrl+Shift+O` (Eclipse), `Ctrl+Shift+O` (Eclipse (macOS))）。 使用 任何更改 选项时，IntelliJ IDEA 会自动同步所有更改。

* 外部更改 ：选择此选项时，IntelliJ IDEA 仅在 VCS 发生更改以及在 IDE 外部对构建文件进行更改后自动同步项目。

Procedure: 将 Maven 配置文件添加到 Maven 项目

如果您想添加文件，例如  `maven.config`  或  `jvm.config` ，可以通过在项目中创建一个空文件来实现。

1. 在   项目   工具窗口中，右键点击您想要创建文件的目录。

2. 在上下文菜单中，选择   新建 | 文件  。

3. 在打开的对话框中，输入文件的名称（  `maven.config` 或  `jvm.config` ）并点击   OK  。

当您导入项目时，IntelliJ IDEA 会读取  `maven.config`  文件中的内容，但请注意，  `jvm.config`  的内容会被忽略。

有关 Maven 配置文件的更多信息，请参阅 [https://maven.apache.org/configure.html](https://maven.apache.org/configure.html)。

## 链接和取消链接 Maven 项目

您可以在一个 IntelliJ IDEA 项目中包含多个 Maven 项目。 如果您将代码保存在不同的项目中或有一些需要处理的遗留项目，这可能会有所帮助。 您可以在 IntelliJ IDEA 中  链接 此类项目并同时管理它们。 您还可以快速从 Maven 结构中删除这些项目。

Procedure: 链接 Maven 项目

1. 打开 [Maven](maven-projects-tool-window.html) 工具窗口。

2. 在   Maven  工具窗口中，点击 ![“Link Maven Projects”图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)以附加 Maven 项目。

3. 在打开的对话框中，选择所需的  `pom.xml`  文件，并点击   OK  。

项目已链接。   Maven   工具窗口显示工具栏和 Maven 实体的树视图。

Procedure: 取消关联 Maven 项目

当您取消关联一个 Maven 项目时，IntelliJ IDEA 会移除所有相关的项目和内容根目录，将 Maven 项目从   Maven   工具窗口和   项目   工具窗口中移除，并停止其同步。 如果您需要完全移除与当前 IntelliJ IDEA 项目之前链接的 Maven 项目，这可能会有所帮助。

1. 在 [Maven](maven-projects-tool-window.html) 工具窗口中，右键点击已链接的项目。

2. 从上下文菜单中选择   取消链接 Maven 项目  （ `Delete` (Windows), `⌦` (macOS), `⌦` (IntelliJ IDEA Classic (macOS)), `⌦` (macOS System Shortcuts), `Delete` (XWin), `Delete` (GNOME), `Delete` (KDE), `Delete` (Emacs), `Delete` (Sublime Text), `⌦` (Sublime Text (macOS)), `Delete` (Visual Studio), `⌦` (Visual Studio (macOS)), `Delete` (NetBeans), `Delete` (Eclipse), `⌦` (Eclipse (macOS))）。 或者，您可以选择链接的项目并点击工具窗口工具栏上的 ![删除图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.remove.svg)。

3. 点击   OK  。

## 将构建和运行操作委托给 Maven

默认情况下，IntelliJ IDEA 使用本机 IntelliJ IDEA 构建器来构建 Maven 项目。 如果您有一个纯 Java 或 Kotlin 项目可能会有所帮助，因为 IntelliJ IDEA 支持 [增量构建](compiling-applications.html#compile_module)，这显著加快了构建过程。 但是，如果您有一个可以动态更改编译的配置，或者您的构建生成了一个具有自定义布局的构件，那么在构建过程中 Maven 更加合适。

Procedure: 使用 Maven 构建项目

1. 点击 ![Maven 设置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.settings.svg) 在   Maven   工具窗口中。 或者，从主菜单中选择  `文件 | 设置 | 构建、执行、部署 | 构建工具 | Maven` 。

2. 点击   Maven   并从列表中选择   运行器  。

3. 在 [运行程序](maven-runner.html)页面上，选择   将 IDE 构建/运行操作委托给 Maven  。

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

4. 点击   OK  。

5. 在主菜单中，前往  `构建 | 构建项目`  `Ctrl+F9` (Windows), `⌘ F9` (macOS), `⌘ F9` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ B` (macOS System Shortcuts), `Ctrl+F9` (XWin), `Ctrl+F9` (GNOME), `Ctrl+9` (KDE), `Ctrl+F9` (Emacs), `Ctrl+F9` (Sublime Text), `Ctrl+F9` (Sublime Text (macOS)), `F7` (Visual Studio), `F7` (Visual Studio (macOS)), `F11` (NetBeans), `Ctrl+F9` (Eclipse), `⌘ B` (Eclipse (macOS))。 IntelliJ IDEA 调用适当的 Maven 目标。

6. 点击 ![“构建”图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.toolwindows.toolWindowBuild.svg)状态栏以在 [Build](build-sync-tool-window.html)工具窗口中查看同步结果。

Procedure: 使用 Maven 运行和调试

选择 [将 IDE 构建/运行操作委托给 Maven](#delegate_run_action) 后，IntelliJ IDEA 会使用 Maven 运行和调试代码。 [HotSwap](altering-the-program-s-execution-flow.html) 也会被触发，类在调试过程中重新加载。

您可以像在其他项目中一样使用常规运行和调试操作。

1. 根据您要使用的操作，从主菜单中选择  `运行 | 运行` 或  `运行 | 调试` 。

2. 请在   运行   工具窗口或在   调试   工具窗口中检查结果， 如果您正在调试您的代码。 例如，当您在 Java 项目中运行 `Ctrl+Shift+F10` (Windows), `⌃ ⇧ R` (macOS), `⌃ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ R` (macOS System Shortcuts), `Ctrl+Shift+F10` (XWin), `Ctrl+Shift+F10` (GNOME), `Ctrl+Shift+F10` (KDE), `Ctrl+Shift+F10` (Emacs), `Ctrl+Shift+F10` (Sublime Text), `Ctrl+Shift+F10` (Sublime Text (macOS)), `Ctrl+Alt+F5` (Visual Studio), `⌃ ⌥ F5` (Visual Studio (macOS)), `Alt+Shift+F6` (NetBeans), `Ctrl+Shift+F10` (Eclipse), `⌃ ⇧ R` (Eclipse (macOS)) main 方法时，IntelliJ IDEA 使用 Maven 运行该类。

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