乍一看，Maven 可能看起来有很多东西，但简而言之，Maven 试图将模式应用于项目的构建基础架构，以便通过提供使用最佳实践的清晰路径来提高理解力和生产力。Maven 本质上是一个项目管理和理解工具，因此提供了一种帮助管理的方法：

如果您想了解更多关于 Maven 的背景信息，您可以查看The Philosophy of Maven和The History of Maven。现在让我们继续讨论您（用户）如何从使用 Maven 中受益。

Maven 可以通过采用标准约定和实践来加快您的开发周期，同时帮助您获得更高的成功率，从而为您的构建过程带来好处。

现在我们已经介绍了一些 Maven 的历史和目的，让我们进入一些真实的例子来帮助您开始使用 Maven！

Maven 的默认值通常就足够了，但如果您需要更改缓存位置或位于 HTTP 代理后面，则需要创建配置。有关更多信息，请参阅配置 Maven 指南。

我们将一头扎进创建您的第一个 Maven 项目！为了创建我们的第一个 Maven 项目，我们将使用 Maven 的原型机制。原型被定义为原始模式或模型，所有其他同类事物都由该模型或模型制成。在 Maven 中，原型是项目的模板，它与一些用户输入相结合，以生成根据用户要求定制的工作 Maven 项目。我们现在将向您展示原型机制是如何工作的，但如果您想了解更多关于原型的信息，请参阅我们的原型介绍。

开始创建您的第一个项目！为了创建最简单的 Maven 项目，请从命令行执行以下命令：

执行此命令后，您会注意到发生了一些事情。首先，您会注意到my-app已为新项目创建了一个名为的目录，该目录包含一个名为的文件，该文件pom.xml应如下所示：

pom.xml包含此项目的项目对象模型 (POM)。POM 是 Maven 中的基本工作单元。记住这一点很重要，因为 Maven 本质上是以项目为中心的，因为一切都围绕着项目的概念。简而言之，POM 包含有关您的项目的所有重要信息，并且本质上是一站式购物，可以找到与您的项目相关的任何信息。了解 POM 很重要，鼓励新用户参考POM 简介。

这是一个非常简单的 POM，但仍然显示了每个 POM 包含的关键元素，因此让我们逐一介绍它们以熟悉 POM 的基本要素：

有关可在 POM 中使用的元素的完整参考，请参阅我们的POM 参考。现在让我们回到手头的项目。

在您的第一个项目的原型生成之后，您还会注意到已创建以下目录结构：

如您所见，从原型创建的项目有一个 POM、一个用于应用程序源代码的源代码树和一个用于测试源代码的源代码树。这是 Maven 项目的标准布局（应用程序源位于${basedir}/src/main/java，测试源位于${basedir}/src/test/java，其中 ${basedir} 表示包含 的目录pom.xml）。

如果您要手动创建一个 Maven 项目，这是我们推荐使用的目录结构。这是一个 Maven 约定，要了解更多信息，您可以阅读我们的标准目录布局简介。

现在我们有了 POM、一些应用程序源和一些测试源，您可能会问...

切换到由 archetype:generate 创建 pom.xml 的目录并执行以下命令来编译您的应用程序源：

执行此命令后，您应该会看到如下输出：

第一次执行此（或任何其他）命令时，Maven 将需要下载执行该命令所需的所有插件和相关依赖项。从全新安装的 Maven 开始，这可能需要相当长的时间（在上面的输出中，大约需要 4 分钟）。如果您再次执行该命令，Maven 现在将拥有它需要的东西，因此它不需要下载任何新内容，并且能够更快地执行该命令。

从输出中可以看出，编译后的类被放置在${basedir}/target/classesMaven 中，这是另一个标准约定。所以，如果你是一个敏锐的观察者，你会注意到通过使用标准约定，上面的 POM 非常小，你不必明确告诉 Maven 你的任何源在哪里或输出应该去哪里。通过遵循标准的 Maven 约定，您可以轻松完成很多工作！只是作为一个随意的比较，让我们看看您在Ant中可能必须做些什么来完成同样的事情。

现在，这只是为了编译单个应用程序源树，并且显示的 Ant 脚本与上面显示的 POM 的大小几乎相同。但是我们会看到我们可以用这个简单的 POM 做更多的事情！

现在您已经成功编译了应用程序的源代码，并且现在您已经有了一些要编译和执行的单元测试（因为每个程序员总是编写和执行他们的单元测试 *nudge nudge wink wink*）。

执行以下命令：

执行此命令后，您应该会看到如下输出：

关于输出的一些注意事项：

如果您只是想编译您的测试源（但不执行测试），您可以执行以下操作：

现在您可以编译您的应用程序源代码、编译您的测试并执行测试，您需要继续进行下一个合乎逻辑的步骤，所以您会问...

制作 JAR 文件非常简单，可以通过执行以下命令来完成：

您现在可以查看${basedir}/target目录，您将看到生成的 JAR 文件。

现在您需要在本地存储库中安装您生成的工件（JAR 文件）（${user.home}/.m2/repository默认位置）。有关存储库的更多信息，您可以参考我们的存储库简介，但让我们继续安装我们的工件！为此，请执行以下命令：

执行此命令后，您应该看到以下输出：

请注意，surefire 插件（执行测试）会查找包含在具有特定命名约定的文件中的测试。默认情况下，包含的测试是：

默认排除是：

您已经完成了设置、构建、测试、打包和安装典型 Maven 项目的过程。这可能是绝大多数项目将使用 Maven 进行的操作，如果您已经注意到，到目前为止您所做的一切都是由一个 18 行文件驱动的，即项目的模型或 POM。如果您查看一个典型的 Ant构建文件，它提供了与我们迄今为止实现的功能相同的功能，您会注意到它已经是 POM 大小的两倍，而我们才刚刚开始！Maven 可以为您提供更多功能，而无需像当前那样对我们的 POM 进行任何添加。要从我们的示例 Ant 构建文件中获得更多功能，您必须不断进行容易出错的添加。

那么你还能免费获得什么？有很多 Maven 插件可以开箱即用，即使是像我们上面那样的简单 POM。我们将在这里特别提到一个，因为它是 Maven 最受重视的特性之一：无需您做任何工作，这个 POM 就有足够的信息来为您的项目生成一个网站！您很可能想要自定义您的 Maven 站点，但如果您时间紧迫，您只需执行以下命令即可提供有关项目的基本信息：

还有许多其他独立的目标也可以执行，例如：

这将target在开始之前删除包含所有构建数据的目录，使其保持新鲜。

请注意，下面显示的文件中版本标记的值pom.xml具有后缀：-SNAPSHOT.

请注意，如果您要连接到在 sshd_confing 中将参数“PasswordAuthentication”设置为“no”的 openssh ssh 服务器，则每次都必须输入密码以进行用户名/密码验证（尽管您可以使用另一个 ssh 登录客户端通过输入用户名和密码）。在这种情况下，您可能希望切换到公钥身份验证。

如果在settings.xml. 有关详细信息，请参阅密码加密。

为了让您开始使用 Maven 的文档系统，您可以使用原型机制使用以下命令为现有项目生成站点：

现在转到创建站点指南，了解如何为您的项目创建文档。

请注意，生命周期适用于任何项目类型。例如，回到基本目录，我们可以创建一个简单的 Web 应用程序：

请注意，这些都必须在一行上。这将创建一个名为的目录，my-webapp其中包含以下项目描述符：

注意元素 - 这告诉 Maven 构建为 WAR。切换到 webapp 项目的目录并尝试：

您会看到target/my-webapp.war构建完成，并且所有正常步骤都已执行。

处理多个模块的概念内置在 Maven 中。在本节中，我们将展示如何构建上面的 WAR，并在一个步骤中包含之前的 JAR。

首先，我们需要pom.xml在另外两个上面的目录中添加一个父文件，所以它应该是这样的：

您将创建的 POM 文件应包含以下内容：

我们需要来自 webapp 的 JAR 依赖项，因此将其添加到my-webapp/pom.xml：

最后，将以下元素添加到pom.xml子目录中的其他两个文件中：

现在，试一试......从顶级目录，运行：

现在已经在 中创建了 WAR my-webapp/target/my-webapp.war，并且包含了 JAR：

这是如何运作的？首先，创建的父 POM（称为app）具有pom定义的模块的包装和列表。这告诉 Maven 在一组项目上运行所有操作，而不仅仅是当前一个（要覆盖此行为，您可以使用--non-recursive命令行选项）。

接下来，我们告诉 WAR 它需要my-appJAR。这做了一些事情：它使它在类路径上可用于 WAR 中的任何代码（在这种情况下没有），它确保 JAR 始终在 WAR 之前构建，并且它指示 WAR 插件将 JAR 包含在它的库目录。

您可能已经注意到这junit-4.11.jar是一个依赖项，但最终并未出现在 WAR 中。原因是test元素 - 它仅用于测试，因此不包含在 Web 应用程序中，因为编译时依赖项my-app是。

最后一步是包含父定义。这确保了 POM 始终可以被定位，即使项目是通过在存储库中查找而与其父项目分开分发的。