注意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、多项目统一环境
- 电脑同时装 Eclipse、VSCode、IDEA;
- 团队统一规定 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 存在限制,部分场景不好用
- 权限 / 只读问题 内置 Maven 放在程序安装目录(C 盘 Program Files),Windows 容易出现读写权限不足,下载依赖报错。 手动装在非系统盘(D:\maven)无权限问题。
- 无法灵活切换 Maven 大版本 比如后续升级 IDEA 到 2023,需要 Maven3.9;或者老项目强制要求 3.6、新项目用 3.9。 内置 Maven 每个 IDEA 版本绑定固定版本,不能自由切换;本地装多个 Maven 文件夹,改环境变量即可切换。
- 排查构建日志、调试 Maven 本身 独立 Maven 可以单独执行命令、打印完整堆栈、调整 JVM 运行参数,排查依赖冲突比 IDEA 内置插件更直观。
6. 团队规范要求
很多公司开发规范强制要求:使用独立本地 Maven,不允许依赖 IDE 内置 Maven。 目的:规避不同 IDE 内置 Maven 版本差异带来的构建 bug(就是你之前遇到的版本兼容报错)。
针对你当前场景的建议
- 只在 IDEA 里写代码、点刷新 / 运行,只用内置 Maven 完全足够,不用额外下载;
- 如果你经常需要在黑窗口执行
mvn打包、部署,就必须单独下载 Maven3.6.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