# Maven 目标

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

您项目中所有可用目标的列表位于 Maven 工具窗口中的 Lifecycle 节点内。 默认情况下，该节点显示您可以运行、调试和管理的基本目标列表。

要查看完整的目标列表，请点击 ![更多选项](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.moreVertical.svg)，并取消   仅显示基本阶段   旁的复选标记。 有关 Maven 生命周期的更多信息，请参见 [Maven Lifecycle Reference](https://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html#lifecycle-reference)。

> **Note:**
> 有关 Maven 工具窗口参考，请参见 [Maven 工具窗口](maven-projects-tool-window.html)。

## 运行 Maven 目标

可以通过多种方式运行 Maven 目标，例如使用   运行任何内容   窗口、使用   Maven   工具窗口中的上下文菜单，或为一个或多个 Maven 目标创建 [运行配置](run-debug-configuration.html)。

Procedure: 从运行窗口运行 Maven goal

1. 在   Maven   工具窗口中，在工具栏上点击 ![执行 Maven Goal](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven.images.executeMavenGoal_dark.svg) 按钮。 或者，按两次 `Ctrl` (Windows), `Ctrl` (macOS), `Ctrl` (IntelliJ IDEA Classic (macOS)), `Ctrl` (macOS System Shortcuts), `Ctrl` (XWin), `Ctrl` (GNOME), `Ctrl` (KDE), `Ctrl` (Emacs), `Ctrl` (Sublime Text), `Ctrl` (Sublime Text (macOS)), `Ctrl` (Visual Studio), `Ctrl` (Visual Studio (macOS)), `Ctrl` (NetBeans), `Ctrl` (Eclipse), `Ctrl` (Eclipse (macOS)) 打开   运行任何内容   窗口。

![运行任何对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_run_anything.png)

2. 在   运行任何内容  窗口中，开始输入您想要执行的目标名称。 窗口还显示了最近的 Maven 目标条目的列表。

如果有多模块项目，并且需要从特定模块执行目标，请在   运行任何内容   窗口右上角的   项目   列表中选择所需模块或目录，并在搜索字段中输入目标名称。

> **Note:**
> 如果您的项目配置了  `离线模式` 、 [配置文件](work-with-maven-profiles.html)或 [跳过测试](work-with-tests-in-maven.html#skip_test)等选项，IntelliJ IDEA 将自动将配置包含在运行范围内。

3. IntelliJ IDEA 运行所选目标并在   运行  工具窗口中显示结果。

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

Procedure: 从上下文菜单运行 Maven 目标

1. 在   Maven   工具窗口中，点击   生命周期   打开 Maven 目标列表。

2. 右键点击所需目标，并从上下文菜单中选择   运行"目标名称"  。 IntelliJ IDEA 运行指定的目标，并将其添加到   运行配置  节点。

Procedure: 通过运行配置运行一个或一组 Maven 目标

IntelliJ IDEA 允许您为一个特定目标或一组多个目标创建运行配置。

1. 在   Maven   工具窗口中，点击   生命周期   打开 Maven 目标列表。

2. 右键点击您要为其创建运行配置的目标。 (要选择多个 Maven 目标，请按 `Ctrl` (Windows), `Ctrl` (macOS), `Ctrl` (IntelliJ IDEA Classic (macOS)), `Ctrl` (macOS System Shortcuts), `Ctrl` (XWin), `Ctrl` (GNOME), `Ctrl` (KDE), `Ctrl` (Emacs), `Ctrl` (Sublime Text), `Ctrl` (Sublime Text (macOS)), `Ctrl` (Visual Studio), `Ctrl` (Visual Studio (macOS)), `Ctrl` (NetBeans), `Ctrl` (Eclipse), `Ctrl` (Eclipse (macOS)) 并高亮显示所需目标。)

3. 从列表中选择   修改运行配置  。

4. 在   创建运行/调试配置："目标名称"  对话框中，指定目标设置（您可以指定任何 Maven 命令和参数），然后点击   OK  。

![上下文菜单](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_tool_window_context_menu.png) IntelliJ IDEA 在   运行配置   节点下显示目标。

![运行配置节点](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_runConfigurations_display.png)

5. 双击目标以运行它或右键点击目标，然后从上下文菜单中选择   运行  。

## 为 Maven 目标配置触发器

IntelliJ IDEA 允许您在项目执行之前运行 Maven goals 或使用目标激活配置设置其他条件。

Procedure:

1. 在   Maven  工具窗口中，点击   生命周期  以打开目标列表。

2. 在打开的列表中，右键点击您希望设置触发器的目标。

3. 从上下文菜单中选择一个激活阶段。

例如，将   构建前执行   操作用作触发器时，具有此类触发器的目标会在运行项目的构建操作 (  `构建 | 构建项目` ) 之前执行。 如果 [生成操作被委托给 Maven](delegate-build-and-run-actions-to-maven.html#delegate_to_maven)，则执行 Maven  `install` 命令。

使用   在重新构建前执行   时，具有此类触发器的目标会在运行项目的重新构建操作 (  `构建 | 重新构建项目` ) 之前执行。 如果 [rebuild action is delegated to Maven](delegate-build-and-run-actions-to-maven.html#delegate_to_maven)，则会执行 Maven  `clean,install` 命令。

![构建前执行选项](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_context_menu_trigger.png)

激活名称将添加到   Maven   工具窗口中所选的目标。

![Maven 触发器的目标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_added_trigger.png)

> **Note:**
> 如果您有独立的模块并且其中一些模块在其目标上有   构建前执行   triggers 操作，那么   构建模块  操作将只执行调用构建操作的模块。

您还可以创建一个运行/调试配置，它依赖于一个 Maven 目标。

Procedure:

1. 在主菜单中，转到  `运行 | 编辑配置`  以打开项目的运行/调试配置。

2. 在   运行/调试配置  对话框中，点击   修改选项  。

3. 在   启动前   部分，选择   添加启动前任务  。

4. 在任务列表中，选择   运行 Maven 目标  。

![运行/调试配置：启动前](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_run_config_run_goal.png)

5. 在   选择 Maven 目标  对话框中，指定一个项目和一个您要在启动项目之前执行的目标。

![选择 Maven 目标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_select_goal.png)

6. 点击   OK  。

## 将 Maven 目标与键盘快捷键关联

您可以将 Maven goal 与键盘快捷键关联起来，并通过单个键执行它。

Procedure:

1. 在   Maven  工具窗口中，右键点击所需目标。

2. 在上下文菜单中，选择  `分配快捷键` 。 将打开 [按键映射](settings-keymap.html) 对话框。

3. 在   按键映射  对话框中，按照   Maven  节点导航到您的目标。

4. 右键点击目标，从打开的列表中选择您想要分配的快捷方式类型。

![“按键映射”对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_shortcut_keymap.png)

5. 在打开的对话框中，根据快捷键类型配置快捷键，然后点击   OK  。

![键盘快捷键对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_keyboard_shortcut_dialog.png) 快捷键会显示在   Maven   工具窗口中的目标旁。

在   按键映射  对话框中，您可以添加一个新的目标，并为其分配快捷键。

Procedure:

1. 在   按键映射   对话框中，在   Maven   节点下，点击   选择一个阶段或目标来分配快捷键  。

2. 在打开的对话框中，选择您需要的目标并点击   OK  。

![“选择 Maven 目标”对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_choose_goal.png)目标已添加到   Maven  节点下的列表中。 现在可以 [配置快捷键](#goal_shortcut)。

## 调试 Maven 目标

您可以为一个或多个 Maven 目标 [创建常规调试配置](run-debug-configuration.html#createExplicitly)。 您还可以在   Maven   工具窗口中选择一个 goal 并启动 [调试会话](debugging-code.html)。

Procedure: 调试 Maven goal

您可以为单个 Maven goal 或可能包含多个 Maven goal 的 Maven 运行配置开始调试会话。

1. 打开   Maven   工具窗口。

2. 在   生命周期   节点下，选择一个您想开始调试会话的目标。 （在   运行配置   节点下查找现有的 Maven 运行配置，以启动已创建配置的调试会话。）

3. 右键点击目标，然后从上下文菜单中选择   调试 [目标名称]  。 IntelliJ IDEA 启动调试会话。