# Maven

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

> **TL;DR**
> `文件 | 设置 | 构建、执行、部署 | 构建工具 | Maven`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 构建、执行、部署 | 构建工具 | Maven`  适用于 macOS

在 IntelliJ IDEA 中如何安装和使用 Maven，请参阅 [Maven 支持](maven-support.html) 部分。

|  条目  |  描述  |
| --- | --- |
|  脱机工作  |     如果选中此复选框，Maven 将在 [offline mode](working-offline.html#maven)下工作，并仅使用本地可用的资源。       此选项对应于  `--offline`  命令行选项。     |
|  以递归方式执行目标  |     如果选中此复选框，构建将递归到嵌套项目中。       清除此复选框对应于  `--non-recursive`  命令行选项。     |
|  打印异常堆栈跟踪  |     选中此选项后，将生成异常堆栈跟踪。       此选项对应于  `--errors`  命令行选项。     |
|  始终更新快照  |  如果希望 IntelliJ IDEA 在同步时更新快照，请选中此复选框。  |
|  输出级别  |  选择所需的输出日志级别，允许插件在  debug 、  info 、  warn 、  error 、  fatal  级别创建消息，或禁用输出日志。  |
|  校验和策略  |  选择下载构件时所需的校验和匹配级别。 可以选择在校验和不匹配时使下载失败  `--strict-checksums` ，或发出警告  `--lax-checksums` 。  |
|  多项目构建失败策略  |     指定在多项目构建中如何处理失败。       有关详细信息，请参阅 [Maven 文档](https://maven.apache.org/guides/mini/guide-multiple-subprojects-4.html#dealing-with-failures)。       您可以选择使构建失败：        * 在第一次失败时，该失败与命令行选项 `--fail-fast` 相对应。 如果子项目构建失败，此选项会立即停止整体构建。 这是默认行为。    * 在末尾失败，这对应于命令行选项 `--fail-at-end` 。    * 忽略失败，这对应于命令行选项 `--fail-never` 。    |
|  插件更新策略  |     从列表中选择插件更新策略。       您可以选择以下内容：        * 检查更新，对应命令行选项 `--check-plugin-updates` 。    * 禁止检查更新，与命令行选项 `--no-plugin-updates` 对应。      此选项在 Maven 3 及更高版本中被忽略。     |
|  线程  `（-T 选项）`   |     使用此字段为并行构建设置  `-T`  选项。 此选项适用于 Maven 3 及更高版本。       如需更多信息，请参阅 [Maven 3 中的并行构建](https://cwiki.apache.org/confluence/display/MAVEN/Parallel+builds+in+Maven+3) 功能。     |
|  Maven 主目录路径  |     使用此列表选择可用的捆绑 Maven 版本（对于 Maven3，需要 3.1 版本及更高）或已解析的系统变量的结果，例如  `MAVEN_HOME` 。 您还可以指定安装在您的计算机上的 Maven 版本。 您可以点击 ![浏览按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven-wrapper.properties`  中定义的 Maven wrapper。 如果找到了 Maven wrapper，那么它将被用作 Maven 主路径。      > **Note:** > Maven2 版本未与 IntelliJ IDEA 捆绑在一起。 如果需要在项目中使用，请下载并启用 [Maven2 支持](https://plugins.jetbrains.com/plugin/19663-maven2-support) 插件。 随后， [在本地安装所需的 Maven 版本](maven-support.html#maven2_install)。    |
|  用户设置文件  |  在文本字段中指定包含 Maven 用户特定配置的文件。 如果您需要指定另一个文件，请检查   重写  选项，点击省略号按钮，然后在   选择 Maven 设置文件  对话框中选择所需的文件。  |
|  本地仓库  |  默认情况下，该字段显示用户主目录下的本地目录路径，该目录存储下载内容，并包含尚未发布的临时构建工件。 如果您需要指定其他目录，请勾选   重写   选项，点击省略号按钮，并在   选择 Maven 本地仓库   对话框中选择所需的路径。 所选路径还会显示在列表中的 [已索引的 Maven 仓库](maven-repositories.html#indexed_maven_reps)。  |
|  使用 .mvn/maven.config 中的设置  |     如果您希望在项目中使用 [maven.config](https://maven.apache.org/configure.html#mvn-maven-config-file) 文件中配置的一组 Maven 选项，请选择此选项。 在这种情况下，此文件中的选项将重写 Maven 设置中指定的相同选项。       例如，如果您在  `maven.config`  文件中添加一个作为 Maven UI 设置一部分的选项，那么 IntelliJ IDEA 将在下次项目同步期间采用该选项的值，并忽略 Maven 设置中指定的值，除非   重写   复选框被选中并且该选项具有此复选框。     |

## See also

### 过程

[Maven](maven-support.html)

### 参考

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

### 外部链接

[http://maven.apache.org/maven-1.x/reference/command-line.html](http://maven.apache.org/maven-1.x/reference/command-line.html)

