小傅哥 bugstack 虫洞栈

# Maven 使用说明和配置

作者：小傅哥
博客：https://bugstack.cn (opens new window)

沉淀、分享、成长，让自己和他人都能有所收获！😄

# 一、前言

Apache Maven (opens new window) 是一个软件项目管理、构建和依赖工具。基于项目对象模型 (POM) 的概念，Maven 可以通过中央信息来管理项目的构建、报告和文档。

简单来说，Apache Maven 最大的核心功能是帮你管理 Jar 包。不知道你是否在最开始学习 Java 开发时，如果有需要依赖其他 Jar 包，则需要把那个 Jar 复制到工程中，并且还需要在 Eclipse 里配置加载 Jar 包才能使用。而现在有 Maven 这样的工具后，一切都变得简单了。工程所需的 Jar 包，只需要配置 POM 就可以直接使用拉取和使用。

# 一、软件下载

Maven 3.8+ 需要 JDK 1.7 或更高版本才能执行。 —— 较为常用的版本

下载：https://maven.apache.org/download.cgi (opens new window)

  • 下载后直接解压就可以，它就是文件，不需要做安装操作。
  • 提醒；如果你是在 Linux 等服务器上有使用需求，而不是配置到 IntelliJ IDEA 则需要配置对应的环境变量。这样才能使用 mvn 命令。

编辑 /etc/profile 文件 sudo vim /etc/profile，在文件末尾添加如下代码：

export MAVEN_HOME=/usr/local/apache-maven-3.8.8
export PATH=${PATH}:${MAVEN_HOME}/bin
1
2

保存文件，并运行如下命令使环境变量生效：

# source /etc/profile

在控制台输入如下命令，如果能看到 Maven 相关版本信息，则说明 Maven 已经安装成功：

# mvn -v
1

# 二、环境配置

Maven /conf/settings.xml 最常用的配置一个是仓库Jar存放的位置，另外一个为了提高拉取Jar包的速度，需要配置阿里云镜像地址。—— 注意配置前，先复制一个 settings.xml.bak 做个备份。

# 1. 存储地址

<localRepository>/Users/fuzhengwei/dev-ops/apache-maven-3.8.8/repository</localRepository>
1

# 2. 镜像仓库

<mirrors>
  <mirror>
    <id>aliyunmaven</id>
    <mirrorOf>*</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
  </mirror>
</mirrors>
1
2
3
4
5
6
7
8
  • 配置上阿里云的仓库以后，Maven 的下载速度就嗖嗖的了！

# 三、使用配置

打开你的 IntelliJ IDEA 如图配置 Maven；

首次打开时：

打开工程时：

  • 配置好你的 Maven 地址就可以使用了。

# 四、命令操作

IntelliJ IDEA Maven 面板提供了操作控制；

  • clean：清理，执行该命令会删除项目路径下的target文件，但是不会删除本地的maven仓库已经生成的jar文件。
  • validate：验证，验证工程正确性，所需信息完整否。
  • compile：编译，大伙都知道java的识别文件是.class，编译生成class文件,编译命令，只编译选定的目标，不管之前是否已经编译过，会在你的项目路径下生成一个target目录，在该目录中包含一个classes文件夹，里面全是生成的class文件及字节码文件。与build区别：只编译选定的目标，不管之前是否已经编译过。
  • test：测试，单元测试。
  • package：打包，将工程文件打包为指定的格式，例如JAR，WAR等（看你项目的pom文件，里面的packaging标签就是来指定打包类型的）。这个命令会在你的项目路径下一个target目录，并且拥有compile命令的功能进行编译，同时会在target目录下生成项目的jar/war文件。如果a项目依赖于b项目，打包b项目时，只会打包到b项目下target下，编译a项目时就会报错，因为找不到所依赖的b项目，说明a项目在本地仓库是没有找到它所依赖的b项目，这时就用到install命令。
  • verify：核实，主要是对package检查是否有效、符合标准。
  • install：安装，将包安装至本地仓库，以让其它项目依赖。该命令包含了package命令功能，不但会在项目路径下生成class文件和jar包，同时会在你的本地maven仓库生成jar文件，供其他项目使用（如果没有设置过maven本地仓库，一般在用户/.m2目录下。如果a项目依赖于b项目，那么install b项目时，会在本地仓库同时生成pom文件和jar文件，解决了上面打包package出错的问题）。
  • build：建造，功能类似compile，区别是对整个项目进行编译。与compile区别及特点：是对整个工程进行彻底的重新编译，而不管是否已经编译过。Build过程往往会生成发布包，这个具体要看对IDE的配置了，Build在实际中应用很少，因为开发时候基本上不用，发布生产时候一般都用ANT等工具来发布。Build因为要全部编译，还要执行打包等额外工 作，因此时间较长。
  • site：站点，生成项目的站点文档。
  • deploy：配置部署，复制到远程仓库。前提需要在工程 POM 和 Maven 里配置上相关的信息以及账号。

# 五、构建配置

<build>
    <finalName>项目名称</finalName>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.0</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <encoding>UTF-8</encoding>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-resources-plugin</artifactId>
            <version>2.5</version>
            <configuration>
                <encoding>UTF-8</encoding>
            </configuration>
        </plugin>
        <!-- 统一设定POM版本信息插件 -->
        <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>versions-maven-plugin</artifactId>
            <version>2.7</version>
        </plugin>
    </plugins>
</build>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

这是一个基本的构建配置；

  • maven-compiler-plugin 指定构建版本
  • maven-resources-plugin 构建资源
  • versions-maven-plugin 用于统一设定工程的版本工具【如图】

# 六、实战技巧

公司中会有很多的内部工程，开发时是怎么管理Jar的呢？

  1. 如果是自己本地验证，那么你需要把你的N个工程，只要是需要被M工程引用的，就需要在N个工程里都操作 Install 操作，让Jar包进入到本地仓库。这样你的其他工程就可以引入了。
  2. 如果你的本地工程已经定义好接口，需要给其他人使用。那么你可以点击deploy部署。这个部署是把你的Jar发布到内部的私有仓库，只公司可见。这个操作之前需要在 POM 里配置发布部署的信息以及账号。

← Git →