【Maven】（二）使用 Maven 创建并运行项目、聊聊 POM 中的坐标与版本号的规则

本文链接：https://blog.youkuaiyun.com/qq_38249409/article/details/129165474

本文介绍了Maven项目创建的多种方式，包括使用Archetype和IDE，并讲解了Maven的目录结构。文章详细解析了pom.xml的基本组成，讨论了Maven坐标和版本号的规则。此外，还涵盖了如何打包成可运行的JAR，以及处理SNAPSHOT版本的特殊性。最后，文章简要总结了Maven仓库和私服的使用预览。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1.前言

（一）5分钟做完 Maven 的安装与配置
 （二）使用 Maven 创建并运行项目、聊聊 POM 中的坐标与版本号的规则
 （三）Maven仓库概念及私服安装与使用附：Nexus安装包下载地址
 （四）图解Maven3依赖的功能特性：依赖范围、依赖传递、依赖冲突
 （五）Maven模块的继承与聚合多模块项目组织构建
 （六）详细聊聊 Maven 的生命周期、阶段(phase)、插件目标(goal)

在上一篇文章中，我们已经快速的安装并配置好了 Maven 的环境，现在就可以开始将 Maven用起来了，在开始创建 Maven 项目之前，先介绍一个本篇文中涉及到的内容，包括：

Maven 的快速开始
Maven 项目的目录结构
POM 文件的基本组成（简要版，更详细的介绍会随着本专题的推进慢慢展开）
坐标、版本号、以及SNAPSHOT的含义
Maven 自带插件的使用

接下来，我们就开始吧！

2.hello-world

首先，我需要创建一个 Maven 的项目，创建项目的方式多种多样，例如：手动创建 Maven 的目录结构与 pom 文件、使用 Archetype 生成Maven 的项目、或者直接使用 IDE 进行创建。

2.1.Archetype 创建

Archetype 是 Maven 用来初始化项目骨架的插件（Maven 有很多自带的插件，很多时候我们都意识不到自己在使用），由于我们使用的是 Maven3，可以直接运行下面的指令：

mvn archetype:generate

第一次运行这个指令的时候，会从中央仓库中下载插件，所以会看到控制台一长串的输出，直到：
在这里插入图片描述
这里的左边那一串数字有点类似于需要使用的 Maven项目目标，右边默认的 1982 指的是maven-archetype-quickstart，我们可以在控制台中找到它：

如果不需要使用其他模板的话，直接回车即可，接下来回提示输入 groupId，artifactId，version 等，这个其实就是生成的 POM 中需要的坐标数据，此处将 groupId 填写为 com.ls.mavendemo ，artifactId 填写为 hello-world（在下面POM的基本组成中会解释为什么），再一顿回车之后，项目就创建成功了。
在这里插入图片描述

2.2.使用 IDE 创建

在实际的开发中，我们可能更多的会使用IDE来生成 Maven 项目，图形化的界面会更加友好，例如使用 Idea 来创建：

File -> new -> project

然后，就可以输入 groupId，artifactId，version 几个参数了：

点击Next -> Finish 项目就创建完成了。

2.3.Maven的目录结构

在这里插入图片描述
忽略掉 .idea 文件夹，上图中的剩余部分就是 Maven 的目录结构了，这种目录结构是 Maven 的规范所规定的，在 src 下面会包含 main 和 test两个文件夹，两者代表了不同的分工环境：

main：写功能代码
test：写测试代码

在这里面的 java 指的是放置代码的文件夹，同样的在 java 的同级目录下，往往还会有一个 resources 文件夹用于放置项目中使用到的配置文件、模板文件等静态文件，例如：xml、properties等。
在这里插入图片描述

3.pom的基本组成

打开 pom.xml ，可以看到里面有大概有70多行配置：

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.ls.mavendemo</groupId>
  <artifactId>hello-world</artifactId>
  <version>1.0-SNAPSHOT</version>

  <name>hello-world</name>
  <!-- FIXME change it to the project's website -->
  <url>http://www.example.com</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.7</maven.compiler.source>
    <maven.compiler.target>1.7</maven.compiler.target>
  </properties>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
  </dependencies>

  <build>
    <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
      <plugins>
        <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
        <plugin>
          <artifactId>maven-clean-plugin</artifactId>
          <version>3.1.0</version>
        </plugin>
        <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
        <plugin>
          <artifactId>maven-resources-plugin</artifactId>
          <version>3.0.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-compiler-plugin</artifactId>
          <version>3.8.0</version>
        </plugin>
        <plugin>
          <artifactId>maven-surefire-plugin</artifactId>
          <version>2.22.1</version>
        </plugin>
        <plugin>
          <artifactId>maven-jar-plugin</artifactId>
          <version>3.0.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-install-plugin</artifactId>
          <version>2.5.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-deploy-plugin</artifactId>
          <version>2.8.2</version>
        </plugin>
        <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
        <plugin>
          <artifactId>maven-site-plugin</artifactId>
          <version>3.7.1</version>
        </plugin>
        <plugin>
          <artifactId>maven-project-info-reports-plugin</artifactId>
          <version>3.0.0</version>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>
</project>

我们先把这个文件改纯净一点，删除一部分内容

build -> pluginManagement：里面的内容是Maven会使用到的默认插件，这里不需要进行配置先删除掉。
url：是建立网站需要的信息，我们现在不需要建站。
properties：是配置的变量，这个常用于统一管理依赖包的版本，后续的文章中会将，这里暂时用不到。

下面是清理过后的 pom.xml 文件：

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.ls.mavendemo</groupId>
  <artifactId>hello-world</artifactId>
  <version>1.0-SNAPSHOT</version>

  <name>hello-world</name>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
  </dependencies>

</project>

先看一下各个标签的含义：

<project> ：POM 的根元素，定义了一些POM相关的规范。
<modelVersion>: POM版本号，我们用的是 Maven3 这里只能是4.0.0
<groupId> <artifactId> <version>：项目的坐标，用于确定一个唯一的项目，下面会详细提到
<name>：当前项目的名称
<dependencies>：当前项目引入的依赖
<dependency>：单个需要引入的具体的依赖包
<scope>：依赖的范围，常见的有 compile 和 test，不同的范围起到包隔离的作用，这个在后面依赖相关的文章中详细讲

3.1.Maven坐标的概念与规则

在一个三维的空间坐标系中，我们可以通过 x,y,z 三个方向的坐标确定做坐标系上的唯一一个点。
Maven的坐标概念与之类似，在建立Maven仓库的时候我们也可以通过 <groupId> <artifactId> <version> 的值来确定唯一一个构件，下面依次来看看这三者的填写规则。

<groupId>：指的是当前构建隶属的实际项目，一般是公司的网址倒序 + 项目名
<artifactId>：一般是指的当前项目中的其中一个模块
<version>：当前项目的版本号

以 SpringBoot 为例：

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter</artifactId>
	<version>2.7.8</version>
</dependency>

org.springframework.boot 就是 Spring 所在公司的 SpringBoot 项目，spring-boot-starter这个项目的其中一个模块，版本号为2.7.8。
同理如果我们要引入Web模块，自然就应该是：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <version>2.7.8</version>
</dependency>

为什么 groupId 不能直接是一个组织呢，要细化到一个项目呢？
一般来说一个公司、组织上不会只有一个项目，如果 groupId 直接占用了组织，那项目名就只有放到 artifactId 中了，但是一个项目也有可能会有过个模块，模块名就没有地方放了。
所以我们在实际开发中创建一个 Maven 项目的时候，可以尽可能的遵守这样的约定。

3.2.版本号规则

看到这里，相信大家已经注意到了，上面引入的 SpringBoot 的版本号是 3位数，而自己创建的 hello-world 项目版本号只有 2位，并且后面还有一个 SNAPSHOT。

Maven 的版本号规则实际上也是业界的通用规则，它的定义方式如下：

{主版本号}.{次版本号}.{增量版本号}-{里程碑版本}

主版本号：一般是指的当前的项目有了重大的架构变动，版本之间几乎完全不兼容，例如：最近出的 SpringBoot3 就已经放弃了Java8，如果不升级 JDK的话，还是只能使用SpringBoot2
次版本号：一般是指的项目的迭代版本，这种版本会修复大量的bug，带来一些小的新特性等，但是没有什么架构上的重大变化。
增量版本号：一般是用于修复一些紧急bug，改动量很小时，可以使用增量版本号。
里程碑版本：就是项目的当前版本处于一个什么样的阶段了，常见的里程碑版本有 SNAPSHOT，alpha，beta，release，GA 等。
在里程碑的版本中，标注SNAPSHOT的为开发版，此时会存在大量的代码变动，alpha和beta分别对应的是内测版与公测版这三个版本都是属于不稳定版本，使用的时候非常容易踩坑，所以一般只用的demo体验，在正式环境中不能使用。
release和GA都属于是稳定的正式版本，可以在正式环境中使用。

下面是SpringBoot的一些版本号，可以体验一下：
在这里插入图片描述

这里需要再提一嘴，SNAPSHOT 在 Maven仓库中有特别的含义，处于这个里程碑版本的项目可以多次install到仓库中，每一次都会覆盖前一次生成的包，但是非 SNAPSHOT 的版本是不能覆盖的，每次install都需要修改版本号。

如果不理解这段话，可以继续关注后续的文章，会讲到如何将项目打包到本地仓库以及推送到私服中。

2.3.打包成可运行的JAR

我们在开发完代码之后，需要将代码打包到测试环境中测试，Maven 提供了项目构建相关的插件，我们只需要直接使用即可。单项目的打包非常简单，我们可以进入到项目所在的根目录中（pom所在目录），执行下面的指令。

mvn clean package

clean：清空上一次生成的target目录，避免最新修改的代码没有被打包到新版本中造成一些意外的情况。
package：将当前代码打成一个可以执行的jar包。

执行完成之后，在src 目录下会出现一个同级的target目录，里面就会出现一个满足当前项目坐标的jar包：
在这里插入图片描述
我们通过 java -jar 运行这个 jar 包，会发现无法运行：

hello-world-1.0-SNAPSHOT.jar中没有主清单属性

如何才能运行呢？
在这里插入图片描述
我们需要执行的是这个App类里面的main方法，而正常的打包方式，没有指定执行它，所以我们需要通过shade插件来指定一下，在pom.xml中加入插件：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <version>3.2.4</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <transformers>
                            <transformer
                                    implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                <mainClass>
                                    com.ls.mavendemo.App
                                </mainClass>
                            </transformer>
                        </transformers>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>