Maven在IDEA中的配置

注意1:Maven版本与IDEA版本需要一一对应,不可随意下载

注意2:每个IDEA中都内置Maven,但是这里还是需要下载,原因为:

1. 终端 / 命令行单独执行 mvn 命令(最常用理由)

内置 Maven 只给 IDEA 内部插件调用,系统 CMD/PowerShell、Git Bash、服务器终端识别不到。

  • 需要打包:mvn clean package
  • 清理、安装、部署私服:mvn install / mvn deploy
  • 测试、版本升级、maven 命令脚本 这些脱离 IDEA 窗口的操作,必须本地独立安装 Maven 并配置环境变量 ,否则系统提示 mvn 不是内部或外部命令
2. 多套 IDE、多项目统一环境
  1. 电脑同时装 Eclipse、VSCode、IDEA;
  2. 团队统一规定 Maven 版本(比如统一 3.6.3); 只用内置 Maven 会出现:不同 IDE 自带 Maven 版本不一致,构建行为有差异,容易出现本地正常、别人电脑报错。 单独装一份全局 Maven,所有工具共用一套配置、一套仓库,环境统一。
3. 自定义 Maven 全局配置更方便

内置 Maven 的配置文件路径很深: IDEA安装目录/plugins/maven/lib/maven3/conf/settings.xml 修改、备份、复制给同事很麻烦。 手动安装的 Maven:

  • conf 文件夹随手就能找到;
  • 可以统一配置私服、镜像、本地仓库路径、仓库账号; 换电脑直接复制整个 maven 文件夹带走,不用重新配置。
4. 服务器、Jenkins 自动化打包部署

线上服务器、CI 流水线(Jenkins/GitLab CI)没有 IDEA,只能靠独立 Maven 环境执行打包脚本。 本地提前用相同版本独立 Maven 调试,保证本地打包和线上打包行为完全一致,避免线上构建异常。

5. 内置 Maven 存在限制,部分场景不好用
  1. 权限 / 只读问题 内置 Maven 放在程序安装目录(C 盘 Program Files),Windows 容易出现读写权限不足,下载依赖报错。 手动装在非系统盘(D:\maven)无权限问题。
  2. 无法灵活切换 Maven 大版本 比如后续升级 IDEA 到 2023,需要 Maven3.9;或者老项目强制要求 3.6、新项目用 3.9。 内置 Maven 每个 IDEA 版本绑定固定版本,不能自由切换;本地装多个 Maven 文件夹,改环境变量即可切换。
  3. 排查构建日志、调试 Maven 本身 独立 Maven 可以单独执行命令、打印完整堆栈、调整 JVM 运行参数,排查依赖冲突比 IDEA 内置插件更直观。
6. 团队规范要求

很多公司开发规范强制要求:使用独立本地 Maven,不允许依赖 IDE 内置 Maven。 目的:规避不同 IDE 内置 Maven 版本差异带来的构建 bug(就是你之前遇到的版本兼容报错)。

针对你当前场景的建议
  1. 只在 IDEA 里写代码、点刷新 / 运行,只用内置 Maven 完全足够,不用额外下载;
  2. 如果你经常需要在黑窗口执行 mvn 打包、部署,就必须单独下载 Maven3.6.3 配置环境变量;
  3. 切记:你的 IDEA2019.3.5 只能搭配 3.6 系列独立 Maven,不要下 3.8/3.9。

1、下载

网址为:https://archive.apache.org/dist/maven/maven-3

选择:apache-maven-版本号-bin.zip

解压maven

2、配置环境变量

(1)系统变量中添加MAVEN_HOME,设置变量值为刚才解压的目录

(2)在用户变量的Path中添加此配置

3、验证安装

重启电脑,输入maven -version,显示版本号,证明安装成功

4、配置本地Maven仓库目录

本地仓库目录相当于远程仓库的一个缓冲,当项目需要下载jar包时首先到本地Maven仓库中进行查找,如果找到就慈宁宫本地Maven仓库下载,找不到去远程仓库进程查找。

默认的本地仓库路径为:${user.home}/.m2/repository

因为项目的依赖会从远程仓库下载后缓存到本地仓库,需要修改配置,将本地仓库指定到空间较大的目录。建议非C盘。

(1)打开Maven安装目录,进入conf目录,打开setting.xml文件进行编辑。

(2)找到localRepository配置,修改为刚才的位置。

(3)在Windows的命令提示符窗口中执行如下命令,检验是否设置成功:

mvn help:system

(4)查看最后命令显示是否为BUILD SUCCESS,同时查看刚才创建的文件夹,是否有文件生成。

cmd命令结果:

文件夹内容显示:

5、修改Maven远程仓库源

Maven默认远程仓库服务器在国外,速度不稳定,可以替换为其他源,以提高开发效率。

再次打开setting.xml文件,加入其他源,命令如下所示:

<mirror>

<id>alimaven</id>

<name>aliyun maven</name>

<url>https://maven.aliyun.com/nexus/content/groups/public/\</url>

<mirrorOf>central</mirrorOf>

</mirror>

配置完成。

6、下载IDEA社区版【注意版本与Maven版本对应】

7、创建Maven项目

(1)设置项目名称为HDFS-helloworld

(2)展开项目,修改pom.xml文件,加入依赖,更新Maven