Maven安装与配置全攻略:Linux环境快速部署指南
1. 安装包放置与解压
1.1 上传安装包
将Maven安装包上传至服务器指定目录,建议使用/usr/local
作为软件安装根目录:
apache-maven-3.6.1-bin.tar.gz
# 复制安装包到目标路径(建议使用sudo提升权限)
sudo cp apache-maven-3.6.1-bin.tar.gz /usr/local/
1.2 解压操作
进入目录后执行解压,系统会自动创建对应版本目录:
cd /usr/local
sudo tar -zxvf apache-maven-3.6.1-bin.tar.gz
2. 创建全局命令软链接
2.1 为什么需要软链接
Linux系统通过PATH
环境变量实现命令全局调用,/usr/local/bin
作为默认搜索路径之一,创建软链接后可直接使用mvn
命令,无需输入完整路径:
# 创建指向mvn执行文件的软链接
sudo ln -s /usr/local/apache-maven-3.6.1/bin/mvn /usr/local/bin/mvn
2.2 验证命令可用性
执行以下命令检查是否配置成功:
mvn -v
正常输出应包含版本信息及Java环境路径,如:
Apache Maven 3.6.1 (xxx...)
Maven home: /usr/local/apache-maven-3.6.1
Java version: 1.8.0_281, vendor: Oracle Corporation
3. 阿里云镜像加速配置
3.1 修改配置文件
进入Maven安装目录的conf子目录,使用文本编辑器修改settings.xml:
sudo vim /usr/local/apache-maven-3.6.1/conf/settings.xml
3.2 镜像配置代码
在<mirrors>
标签内添加以下内容(建议替换原有镜像配置):
<mirror>
<id>aliyunmaven</id>
<mirrorOf>central</mirrorOf>
<name>阿里云Maven镜像</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
或者直接使用张师傅提供的settings.xml
文件
settings.xml
3.3 配置生效验证
执行构建命令测试镜像加速效果:
mvn clean install -Dmaven.test.skip=true
4. 常见问题排查
4.1 命令无法识别
检查软链接是否指向正确路径,执行ls -l /usr/local/bin/mvn
确认链接状态
4.2 镜像配置不生效
确认settings.xml中<mirrors>
标签位置正确,建议使用grep -i aliyun /usr/local/apache-maven-3.6.1/conf/settings.xml
快速定位配置
4.3 Java环境异常
Maven依赖Java环境运行,通过java -version
确认JDK版本是否符合要求(建议使用JDK1.8及以上版本)
评论区