Maven在IDEA中的配置 📅 2026/6/27 22:42:59 注意1Maven版本与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修改、备份、复制给同事很麻烦。 手动安装的 Mavenconf 文件夹随手就能找到可以统一配置私服、镜像、本地仓库路径、仓库账号 换电脑直接复制整个 maven 文件夹带走不用重新配置。4. 服务器、Jenkins 自动化打包部署线上服务器、CI 流水线Jenkins/GitLab CI没有 IDEA只能靠独立 Maven 环境执行打包脚本。 本地提前用相同版本独立 Maven 调试保证本地打包和线上打包行为完全一致避免线上构建异常。5. 内置 Maven 存在限制部分场景不好用权限 / 只读问题内置 Maven 放在程序安装目录C 盘 Program FilesWindows 容易出现读写权限不足下载依赖报错。 手动装在非系统盘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解压maven2、配置环境变量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:system4查看最后命令显示是否为BUILD SUCCESS同时查看刚才创建的文件夹是否有文件生成。cmd命令结果文件夹内容显示5、修改Maven远程仓库源Maven默认远程仓库服务器在国外速度不稳定可以替换为其他源以提高开发效率。再次打开setting.xml文件加入其他源命令如下所示mirroridalimaven/idnamealiyun maven/nameurlhttps://maven.aliyun.com/nexus/content/groups/public//urlmirrorOfcentral/mirrorOf/mirror配置完成。6、下载IDEA社区版【注意版本与Maven版本对应】7、创建Maven项目1设置项目名称为HDFS-helloworld2展开项目修改pom.xml文件加入依赖更新Maven