Maven安装、仓库配置、命令使用

Maven 是现在非常流行的 Java 项目依赖管理工具,简单、方便。Maven的安装也非常容易。

Maven安装

下载安装包

下载 Maven 安装包:https://maven.apache.org/download.cgi

1
2
Linux:apache-maven-3.5.3-bin.tar.gz
Windows:apache-maven-3.5.3-bin.zip

2020.03.11 补充

Maven 最新版本是 3.6.3 了。注意:3.6.2 版本与 IDEA 2019 存在版本不兼容的问题,会报错:Unable to import maven project,建议使用 3.6.1。

安装包解压

解压到安装目录

1
2
Linux:$ tar zxvf apache-maven-3.5.3-bin.tar.gz -C /usr/local/maven
Windows: 右键解压到安装目录,D:\Program Files\apache-maven-3.5.3

设置环境变量

Linux

  1. 编辑 profile 文件,在文件底部添加 maven 环境的设置

    1
    2
    3
    4
    5
    6
    7
    $ vim /etc/profile

    输入下面内容:
    #set maven enviroment
    export MAVEN_HOME=/usr/local/maven
    export CLASSPATH=$CLASSPATH:$MAVEN_HOME/lib
    export PATH=$PATH:$MAVEN_HOME/bin
  2. 刷新文件, 使立即生效

    1
    $ source /etc/profile
  3. 验证

    1
    2
    $ mvn -v
    输出 Maven 的版本信息表示成功。

    windows

  4. 右键【此电脑】 → 【属性】 → 【高级系统设置】 → 【系统属性】窗 → 【高级】选项 → 【环境变量】 → 【系统变量】 → 【新建】

    1
    2
    变量名:MAVEN_HOME 
    变量值:D:\Program Files\apache-maven-3.5.3
  5. 环境变量设置 Path

    1
    2
    系统变量, 编辑 Path, 增加 MAVEN_HOME 项, 如下:
    %MAVEN_HOME%\bin
  6. 验证:运行 → cmd

    1
    2
    mvn -v
    输出 Maven 的版本信息表示成功。

    Maven仓库

设置本地仓库

Linux 环境和 Windos 环境设置仓库的操作一样。

  1. 打开 maven 的设置文件

    1
    apache-maven-3.5.3/conf/settings.xml
  2. 设置本地仓库
    在 setting 标签下找到 localRepository,取消注释,或复制另起一行,添加本地仓库所在路径
    Linux:

    1
    <localRepository>/data/repository</localRepository>

    Windows:

    1
    <localRepository>D:\repository</localRepository>

    设置阿里仓库

国内推荐使用阿里的 Maven 仓库,在 setting 标签下找到 mirrors 标签,在里面添加 mirror镜像资源

1
2
3
4
5
6
<mirror>
<id>aliyunmaven</id>
<mirrorOf>*</mirrorOf>
<name>阿里云公共仓库</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>

使用代里仓库

如果想使用其它代理仓库,可在<repositories></repositories>节点中加入对应的仓库使用地址。以使用 spring 代理仓为例:

1
2
3
4
5
6
7
8
9
10
<repository>
<id>spring</id>
<url>https://maven.aliyun.com/repository/spring</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

在你的 pom.xml 文件<denpendencies></denpendencies>节点中加入你要引用的文件信息:

1
2
3
4
5
<dependency>
<groupId>{groupId}</groupId>
<artifactId>{artifactId}</artifactId>
<version>{version}</version>
</dependency>

执行拉取命令:

1
mvn install

Maven命令

可以使用 mvn -h | --help查看命令帮助。

mvn参数

命令参数 全量参数 描述
mvn -v –version 显示版本信息
mvn -V –show-version 显示版本信息后继续执行Maven其他目标
mvn -h –help 显示帮助信息
mvn -e –errors 控制Maven的日志级别,产生执行错误相关消息
mvn -X –debug 控制Maven的日志级别,产生执行调试信息
mvn -q –quiet 控制Maven的日志级别,仅仅显示错误
mvn -Pxxx –activate-profiles 激活 id 为 xxx 的profile (如有多个,用逗号隔开)
mvn -Dxxx=yyy –define 指定Java全局属性
mvn -o –offline 运行offline模式,不联网更新依赖
mvn -N –non-recursive 仅在当前项目模块执行命令
不递构构建到子模块
mvn -pl –projects 在指定模块上执行命令
mvn -ff –fail-fast 遇到构建失败就直接退出
mvn -fn –fail-never 无论项目结果如何,构建从不失败
mvn -fae –fail-at-end 仅影响构建结果,允许不受影响的构建继续
mvn -C –strict-checksums 如果校验码不匹配的话,构建失败
mvn -c –lax-checksums 如果校验码不匹配的话,产生告警
mvn -U –update-snapshots 强制更新snapshot类型的插件或依赖库
默认一天只会更新一次snapshot依赖
mvn -npu –no-plugin-updates 对任何相关的注册插件,不进行最新检查
基于本地仓库当前可用的所有插件版本
使用该选项使Maven表现出稳定行为
该命令已无效,仅保留用于向后兼容
mvn -cpu –check-plugin-updates 强制对插件进行最新检查更新
即使项目POM里指定了Maven插件版本
还是会强制更新。
该命令已无效,仅保留用于向后兼容
mvn -up –update-plugins [mvn -cpu]的同义词
mvn -B –batch-mode 以非交互(批处理)模式运行(禁用输出颜色)
当Mven需要输入时,它不会停下来接受用户的输入,
而是使用合理的默认值
mvn -f --file <file> 强制指定使用的POM文件
mvn -s --settings <arg> 用户配置文件的备用路径
mvn -gs --global-settings <file> 全局配置文件的备用路径
mvn -emp --encrypt-master-password <password> 加密主安全密码,存储到Maven settings文件里
mvn -ep --encrypt-password <password> 加密服务器密码,存储到Maven settings文件里
mvn -npr --no-plugin-registry 对插件版本不使用~/.m2/plugin-registry.xml
(插件注册表)里的配置

mvn参数示例

mvn命令

Maven 安装完后,进入到项目代码根目录,就可以使用 mvn 命令来执行编译、打包、安装、发布、测试、清空的操作。

1
2
3
4
5
6
7
8
9
10
11
12
# 删除 target 目录
mvn clean
# 编译,生成target目录及里面文件
mvn compile
# 打包,包含了compile,将编译后的文件打包成 jar 包
mvn package
# 安装到本地仓库,包含了 compile,package
mvn install
# 发布到远程仓库,包含了 compile,package,install
mvn deploy
# 执行测试
mvn test

IDE配置Maven

  1. IDEA:【File】 → 【Settings | Default Settings】 → 【Build,Execution,Deployment】 → 【Build Tools】 → 【Maven】 → 【Maven home directory】,选择 Maven 的安装目录;也可以手动选择和覆盖 settings 文件目录 和 本地仓库地址。
  2. Eclipse:【Windows】 → 【Prefrences】 → 【Maven】 → 【User Settints】 → User Settings,选择 Maven 安装目录里 /conf/settings.xml 文件

安装JAR包到本地仓库

有些 jar 包是私有的并没有发布到 Maven 公共仓库,提供的只有一个 jar 包文件,Maven 工程需要引入该文件,需要先将其安装到本地仓库才能被引用。

安装命令如下:

1
mvn install:install-file -Dfile=jar包的位置 -DgroupId=输入groupId -DartifactId=输入artifactId -Dversion=版本号 -Dpackaging=jar

安装成功后,就可以在 Maven 的本地仓库,根据 groupId 和 版本号找到安装的文件了。

Maven插件

Maven 插件 可以很好的辅助构管理和构建项目。

Spring Boot 项目若出现找不到 spring-boot-maven-plugin 插件,可在项目的 pom 文件里指定插件库或在 Maven 的 settings.xml 文件里统一设置。

项目 pom.xml 中添加:

1
2
3
4
5
6
7
<pluginRepositories>
<pluginRepository>
<id>alimaven spring plugin</id>
<name>alimaven spring plugin</name>
<url>https://maven.aliyun.com/repository/spring-plugin</url>
</pluginRepository>
</pluginRepositories>

Maven settings.xml 中添加:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<profiles>
<profile>
<id>spring plugins</id>
<activation>
<jdk>spring plugins</jdk>
</activation>
<pluginRepositories>
<pluginRepository>
<id>spring plugins</id>
<name>Spring plugins</name>
<url>https://maven.aliyun.com/repository/spring-plugin</url>
<layout>default</layout>
<snapshotPolicy>always</snapshotPolicy>
</pluginRepository>
</pluginRepositories>
</profile>
</profiles>
作者

光星

发布于

2018-06-20

更新于

2022-06-16

许可协议

评论