当前位置：首页 > news >正文

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

news 文章来源：https://blog.csdn.net/qq_38249409/article/details/129165474 2025/4/21 16:17:16

文章目录

1.前言
2.hello-world
- 2.1.Archetype 创建
- 2.2.使用 IDE 创建
- 2.3.Maven的目录结构
3.pom的基本组成
- 3.1.Maven坐标的概念与规则
- 3.2.版本号规则
- 2.3.打包成可运行的JAR
4.结语

1.前言

本系列文章记录了从0开始到实战系统了解 Maven 的过程，Maven 系列历史文章：

（一）5分钟做完 Maven 的安装与配置

在上一篇文章中，我们已经快速的安装并配置好了 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><transformerimplementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"><mainClass>com.ls.mavendemo.App</mainClass></transformer></transformers></configuration></execution></executions></plugin></plugins>
</build>

在 mainClass 中指定需要运行的类的全类名
在这里插入图片描述
再次重试打包运行，运行成功。

4.结语

本篇讲述了如何使用 Maven 自带的插件以及IDE 创建、打包、运行项目，同时介绍了 pom.xml 文件的基本组成，以 SpringBoot为例，介绍了坐标和版本号的使用规则。

到目前为止，已经可以使用Maven来进行一些简单的开发工作了，但距在公司中与同事一起协作开发较大的项目还有一定的差距，可以继续关注本专题的后续文章。

下一篇将会讲述 Maven 仓库的使用以及 Maven 私服的安装和使用。

如果觉得本文有帮助的话，可以帮忙点点赞哦！