干了好几年Java开发经常被问到Maven怎么装。这事看着简单真要动手配起来坑一个接一个环境变量配完不生效、IDEA里依赖红一片、settings.xml找不着、镜像仓库配了不下载……每次帮人弄都得折腾半小时。这篇我按2026年这个时间节点常用的安装方式把整个过程从下载、解压、配环境变量到IDEA集成、换镜像源一次讲清楚你可以直接照着抄。先说清楚一件事Maven不是Java也不是IDEA的插件它是个独立的构建工具。你写Java项目总得管理依赖吧总不能把几十个jar手动拖到lib目录里。Maven干的就是这件事——通过一段配置自动从远程仓库把依赖拉下来再帮你把项目编译、测试、打包。它本身用Java写的所以你机器上必须先有JDK没装过JDK的人别急着动Maven先把JDK装好再说。下面直接上手我这套流程Windows和Mac都覆盖Linux也顺带提一句。你按自己系统对号入座就行。1. Maven到底解决了什么问题1.1 没有Maven的日子有多折腾早几年做Java项目最头疼的就是那几十上百个jar包。从网上下个压缩包手动解压到项目里再右键Build Path一个个加进去。到了新环境把项目拷过去缺了这个那个依赖全得重新找。版本冲突更离谱两个jar包互相依赖不同版本的第三方库折腾一晚上跑了宕机查半天发现是版本问题。Maven把这一切变成了自动化。你在pom.xml里写一行依赖坐标比如dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId version3.3.0/version /dependencyMaven就会自动去中央仓库找这个jar连带被它依赖的其它jar一起拉到本地。你换个电脑、换个团队工程一clone执行一条mvn clean install所有依赖自动归位。这就是依赖管理。1.2 Maven的三板斧依赖、生命周期、标准目录依赖管理只是最表面的一层Maven真正的价值在于它定义了一套项目构建的“规矩”。第一是依赖坐标体系。每个构件用groupId、artifactId、version三个坐标唯一定位国内常说的“GAV”就是这个。不管jar藏在哪个仓库坐标对上了就能找到。第二是标准的生命周期。编译、测试、打包、部署Maven把这一整套动作拆成了clean、compile、test、package、install、deploy等等阶段。你只要知道mvn clean install这条命令它就会自动帮你依次执行“清理→编译→测试→打包→装到本地仓库”。我日常工作里90%的情况一条clean install就够。第三是约定优于配置。Maven规定了源码目录结构src/main/java放业务代码src/main/resources放配置文件src/test/java放测试代码。谁接手项目都不用问“代码放哪个目录”一看结构就懂。这也是为什么一堆工程规范化工具都从这个标准起步。1.3 哪些人需要装Maven用IDEA或Eclipse做Java开发的人新版的Spring Boot、MyBatis等框架全都依赖Maven管理。做自动化构建、CI/CD流水线的人不管是Jenkins还是GitLab CI拉代码之后第一步基本都是跑mvn命令。去公司入职领了新电脑要搭Java环境的人——这个场景最多我写这篇教程也是顺手给这类朋友当个参考。有人问Gradle不是也挺流行吗没错Android生态和部分新项目已经用Gradle了但Java后端、Spring生态里Maven依然是绝对主流你出去看招聘要求写上“熟悉Maven/Gradle”的十个里有八个主要指Maven。所以装它不亏。2. 安装前的版本选择与踩坑预警2.1 先别急着下最新版本我见过不少人跑到Maven官网看到最新版本就下载结果和自己的IDEA版本、JDK版本动不动就打架。2026年这个时候Maven稳定主力版本是3.9.x系列比如3.9.6、3.9.9。它兼容性好IDEA内置默认的Maven也是3.x分支社区资料最多遇到问题好搜。网上常有人搜“Maven 3.7下载”这里明确说一句官方从来没有出过3.7版本这是搜索时常见的一个误区。真实版本序列大致是3.5.x → 3.6.x → 3.8.x → 3.9.x。如果看到哪个网站写着“Maven 3.7最新版”你基本可以判断那是乱写的非官方发布物趁早别碰。2.2 版本搭配参考我自己实测下来比较稳的组合整理成表格方便你对照使用场景推荐JDK版本推荐Maven版本说明老项目维护JDK 8JDK 8Maven 3.6.3最经典的老组合稳定得离谱常规Spring Boot 2.x项目JDK 8或11Maven 3.8.8公司项目最常见的组合Spring Boot 3.x / JDK 17JDK 17Maven 3.9.x新项目首选兼容性最好2026年新启动的项目JDK 21Maven 3.9.x长期稳定支持最新LTS需要注意一个反向问题Maven 3.9.x对JDK 8也能用但有些新版插件不支持JDK 8所以老项目别乱升级。一句话新项目用新老项目用旧别为了追求版本号最新把整个环境搞崩。2.3 下载渠道怎么选Maven是Apache基金会的顶级项目官方下载入口在maven.apache.org进去以后找“Download”页面往下拉到Files区域下载Binary zip archive或Binary tar.gz archive。这两个都是编译好的可直接运行包区别只是压缩格式Windows用zipMac/Linux用tar.gz。这里有个细节下载页面同时提供源码包Source它不是给你用的是给想研究源码的人准备的别下错。国内网络直连Apache官网偶尔慢用国内镜像站也可以但最好从官方镜像列表里挑一个别去不知名站点下载防止exe安装包捆绑东西。Maven官方发布的是zip或tar.gz压根没有exe安装版看到“Maven安装版.exe”的基本可以关掉页面了。下载完成后解压出来的目录我建议放在纯英文路径下比如D:\dev\apache-maven-3.9.9或者/Users/你的名字/Dev/apache-maven-3.9.9。路径里带空格、带中文后面配环境变量和IDEA时容易出现莫名其妙的问题这个习惯从第一天就养成。3. Windows下的安装与配置实操3.1 解压后先看一眼目录结构Maven解压出来之后目录结构大概是这样的apache-maven-3.9.9/ ├── bin/ # mvn命令所在目录 ├── boot/ # Maven自己的类加载器 ├── conf/ # 核心配置settings.xml就在这 ├── lib/ # Maven运行所需的jar └── LICENSE/...其中bin目录里Windows下用的是mvn.cmdMac/Linux下用的是mvn。配置好环境变量后就是靠这个命令来干活。conf/settings.xml是全局配置文件你后面配置镜像仓库、本地仓库路径全在这改这个文件极其重要。3.2 环境变量配置的完整步骤Windows配置环境变量的路径经常有人找不着我说详细点右键“此电脑”或“我的电脑”选“属性”。左侧找到“高级系统设置”点开。弹出“系统属性”窗口点右下角“环境变量”。在“系统变量”区域点击“新建”变量名填MAVEN_HOME变量值填你的Maven解压路径比如D:\dev\apache-maven-3.9.9。新建完之后在系统变量里找到Path变量双击打开点“新建”加一行%MAVEN_HOME%\bin确认保存。以前老版本的教程让写;%MAVEN_HOME%\bin;加在原来内容的末尾Win10/11的编辑器里直接新增一行更不容易配错。配完一定要验证。打开新的命令行窗口注意是新开的窗口旧窗口里环境变量不会刷新执行mvn -v能输出类似下面的信息就说明成功了Apache Maven 3.9.9 ... Maven home: D:\dev\apache-maven-3.9.9 Java version: 17.0.11 ...注意Java version这一行很重要它显示Maven实际用的哪个JDK。马甲没匹配上后面的构建会报错。3.3 为什么明明配置了却不生效环境变量配完了mvn命令还是提示“不是内部或外部命令”这个问题排障思路一般是这几条第一命令行窗口是不是旧的。Win10以上系统按住Win键重新打开一个新窗口再试旧窗口不刷新环境变量。第二Path里是不是写错了。很多人习惯把值写成D:\dev\apache-maven-3.9.9\bin\末尾多一个反斜杠都没事但如果是%MAVEN_HOME%\bin;这种老式写法前面的变量名拼错了也会失效。检查一下MAVEN_HOME本身有没有拼错。第三Path里系统变量到底写没写进去。Win11里环境变量编辑窗口“新建”一条可能因为输入法问题把%字符输成了中文全角符号这个很隐蔽。实在不行直接在Path里改成绝对路径D:\dev\apache-maven-3.9.9\bin虽然不优雅但绝对有效。Windows 7这种老系统如果没装最新的补丁包mvn -v可能报缺java_home之类的错本质还是JDK没配对。老系统我建议直接用免安装的zip包不要折腾什么服务化安装反正Maven本来就是个绿色软件。4. Mac与Linux的安装要点4.1 Mac上用Homebrew一行搞定Mac用户最简单的方式是走Homebrewbrew install maven它会自动把依赖的openjdk也装上如果你没装JDK的话。安装完执行mvn -v验证。这种方式装完的Maven路径在/opt/homebrew/Cellar/maven/...Apple Silicon或/usr/local/Cellar/maven/...设置一下MAVEN_HOME指向它就行了。如果不喜欢Homebrew手动安装和Windows步骤大同小异解压tar.gz到/Users/你的用户名/Dev然后打开~/.zprofilemacOS现在默认zsh或~/.bash_profile追加export MAVEN_HOME/Users/你的用户名/Dev/apache-maven-3.9.9 export PATH$MAVEN_HOME/bin:$PATH保存后执行source ~/.zprofile让配置生效。注意Mac环境变量配置讲究还挺多有时候你在终端里配好了重启IDEA没生效那是因为图形应用不读shell配置文件这种场景直接在IDEA里指定Maven home更靠谱。4.2 Linux服务器上装Maven公司服务器的Linux一般没有图形界面用命令行装更利索。以CentOS/RHEL系列为例cd /opt wget https://dlcdn.apache.org/maven/maven-3/3.9.9/binaries/apache-maven-3.9.9-bin.tar.gz tar -zxvf apache-maven-3.9.9-bin.tar.gz mv apache-maven-3.9.9 maven然后编辑/etc/profileexport MAVEN_HOME/opt/maven export PATH$MAVEN_HOME/bin:$PATHsource /etc/profile之后mvn -v验证。服务器上建议把JAVA_HOME也显式写好因为你不知道服务器上的默认java指向哪里写清楚了少走弯路。Ubuntu系倒是可以直接apt install maven但注意这样装出来的版本一般偏旧比如还是3.8.x需要新特性时就得手动装官方包。5. settings.xml配置文件是重头戏5.1 本地仓库路径必须先改Maven默认把下载的jar放在用户目录下的.m2/repository也就是C:\Users\你的用户名\.m2\repository。这个路径最大的问题是占C盘空间一个项目动辄几百兆的依赖几套项目搞下来C盘分分钟亮红。打开conf/settings.xml找到localRepository这个标签默认是被注释掉的改成自己的目录localRepositoryD:/dev/maven-repo/localRepository这里用正斜杠更稳Windows也认不用写转义。改完以后所有依赖统一放到这个路径C盘不膨胀重做系统也不至于全丢。有人问.m2目录下没有settings.xml文件怎么办这很正常。Maven默认全局配置在conf/settings.xml用户级的~/.m2/settings.xml本来就不会自动生成需要你手动创建。你可以直接把conf/settings.xml复制一份过去在里面改也可以新建一个空文件只写需要的配置。IDEA里默认会优先读.m2/settings.xml所以想让某个项目单独用一套配置就把它放在.m2里优先级高于全局配置。5.2 阿里云镜像仓库配置Maven默认从中央仓库repo.maven.apache.org拉依赖国内网络访问经常卡到怀疑人生一个spring-boot-starter-web等三分钟。解决这个问题的核心就是配置国内镜像阿里云是其中最稳的选择。在settings.xml的mirrors标签里加mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror这个public聚合仓库已经把jcenter、central、spring仓库都汇总进去了日常开发用它一个就够。配置完以后新建项目跑一次mvn clean install你会发现下载速度从几十KB/s直接跳到几MB/s。5.3 配置多个镜像仓库的正确姿势有些人问我公司内部有私服Nexus我也想用阿里云能不能同时配可以。mirrors里是可以放多个mirror的但有个关键规则Maven取第一个匹配的镜像顺序很重要。比如公司私服优先级最高就把它放前面阿里云放后面兜底mirrors mirror idnexus/id mirrorOf*/mirrorOf urlhttp://你的私服地址/repository/maven-public//url /mirror mirror idaliyunmaven/id mirrorOfcentral/mirrorOf urlhttps://maven.aliyun.com/repository/public/url /mirror /mirrors注意mirrorOf的值*表示匹配所有仓库central表示只匹配中央仓库external:*表示匹配除本地仓库之外的所有远程仓库。如果你公司私服配了*那么所有依赖都会从私服走阿里云镜像就永远用不上了这就是它存在的意义。反过来如果你的mirrorOfcentral/mirrorOf放在前面那Spring等其它仓库还是会直连中央仓库速度照样慢。想全走阿里云直接把mirrorOf写成*也行。5.4 JDK编译级别与插件管理在profiles里还可以配JDK版本防止IDEA里默认编译级别出现invalid target release这类问题profile idjdk-17/id activation activeByDefaulttrue/activeByDefault jdk17/jdk /activation properties maven.compiler.source17/maven.compiler.source maven.compiler.target17/maven.compiler.target /properties /profile这个配置的含义是当检测到JDK 17时就自动把编译级别设成17。你把数字改成自己用的JDK版本即可。很多老项目升级到新JDK后编译报错就是这里忘了改。6. IDEA里的Maven集成6.1 IDEA用内置Maven还是自己装的IDEA自带了一个Maven但自带版本往往不是你等会儿要手动配置的版本而且settings.xml不一定是你想要的。我更推荐把IDEA指向自己装的那个Maven。打开IDEA进入File - SettingsMac上是IntelliJ IDEA - Preferences搜索Maven展开找到Maven home path点右侧...按钮选择你的Maven解压目录。同时把User settings file也指到你的settings.xml路径IDEA会自动识别并加载。这里会看到一个选项叫“Override”表示让IDEA强制使用这个用户配置勾上它再点Apply。如果你从头到尾装过MavenIDEA里这里其实就不用动太多关键是别让IDEA拿它默认的那套配置去拉依赖否则你在settings.xml里配的阿里云镜像和本地仓库路径全用不上。6.2 把Maven设为IDEA默认配置上面那套配置只对当前项目生效。如果你不想每个新项目都改一遍点File - New Projects Setup - Settings for New Projects再走一遍同样的路径设置Maven home和settings文件。这样所有新建项目会默认使用你自己装的Maven。很多人在公司内部项目里犯一个错误项目A的Maven设置是公司私服项目B新建时把私服指错成了中央仓库导致依赖全部下载失败。把默认配置设好能少踩不少坑。6.3 IDEA里最常用的几个Maven操作配置完成后IDEA右侧会有一个Maven工具窗口或者你点侧边的“M”图标。常用的操作双击clean清理之前编译的target目录。双击install编译、打包并安装到本地仓库。双击package只打包不安装到本地仓库。右键项目名 -Run Maven可以自定义命令。命令行里最常用的组合是mvn clean install -DskipTests跳过测试打包。IDEA里对应就是先双击clean再双击install或者直接在Terminal窗口里执行这条命令。我实测下来命令行的报错信息比IDEA图形界面更完整排查依赖问题我一般直接开Terminal跑效率高得多。6.4 IDE里的Maven工具栏不见了怎么找回有人升级IDEA之后发现右侧Maven工具栏消失或者Maven窗口是空的。这个恢复方法其实很固定菜单栏View - Tool Windows - Maven手动打开。如果还不行检查项目结构右键项目根目录 -Add Framework Support选Maven让IDEA重新识别。再不然就是这个项目压根没被IDEA识别成Maven项目在项目根目录pom.xml上右键选Add as Maven ProjectIDEA会重新导入。这个操作基本能解决95%的同类问题。还有一个冷门原因IDEA里Maven被配置成本地模式的“Do not build”或者Settings里的Maven importer被停用了。去Build Tools - Maven里把Import Maven projects automatically勾上问题就解了。7. 常见问题与排查方法7.1 mvn命令能用但IDEA里依赖红一片这种情况十有八九是IDEA没有用你配置的Maven settings。解决方法顺一遍确认File - Settings - Maven的User settings file指向你改了镜像的settings.xml。确认Local repository路径和settings.xml里的localRepository一致。如果改了配置还是红执行IDEA右侧Maven窗口里的刷新按钮或者点Reload All Maven Projects。依赖还是报红就看错误信息。常见的比如Cannot resolve ...大概率是没下载下来把.m2/repository里对应的目录删了重新加载一次强制触发下载通常就好了。7.2 mvn clean install报错怎么看原因命令执行报错时不要慌往下翻日志找关键词日志关键词大致原因处理方向Failed to collect dependencies依赖下载失败换镜像源或检查依赖坐标Could not resolve plugin插件下载失败检查settings.xml的mirror配置Invalid target releaseJDK编译级别不匹配改pom.xml或settings.xml里的compiler属性The forked VM terminated单元测试线程崩了用-DskipTests先跳过测试排查Non-resolvable parent POM父pom找不着检查GAV坐标或本地仓库里有没有父工程这里有个我个人的习惯报错解决完以后跑一次mvn clean install -X看debug日志能把这过程中下载了哪些包、走了哪个仓库看得一清二楚。排查依赖问题特别有用。7.3 .m2目录下没有settings.xml前面提过了.m2目录下默认不会有settings.xml。它和conf/settings.xml的区别在于conf/settings.xml是全局默认配置.m2/settings.xml是用户级配置后者会覆盖前者。但两者都不存在时Maven用内置的最原始配置只有中央仓库没有镜像。如果你要用本教程里说的阿里云镜像、自定义本地仓库就手动建一个.m2/settings.xml把配置贴进去。建议从conf/settings.xml复制一份再修改这样结构完整不容易写漏标签。7.4 老Windows 7系统安装时的特殊问题现在公司里偶尔还能遇到Windows 7老机器装Maven有几个特定坑第一Maven 3.9.x对Windows 7支持一般如果跑不起来退回Maven 3.6.3兼容性好得多。第二Window 7默认的TLS版本旧连不上新版中央仓库的HTTPS端口需要在JDK里调一下java.security配置文件或者干脆直接用阿里云镜像的HTTP地址。第三老机器内存小跑mvn install经常内存不足可以在MAVEN_OPTS里加一句MAVEN_OPTS-Xms256m -Xmx1024m这些都是老系统特有的问题新机器基本碰不到。7.5 关于Maven依赖报错与最新工具链的一点补充2026年前后Java生态里大量项目开始集成AI开发工具链比如io.modelcontextprotocolMCP相关的Java SDK已经发布到Maven中央仓库这些照样走Maven依赖管理。它的工作原理和你拉一个Spring Boot依赖没什么区别dependency groupIdio.modelcontextprotocol/groupId artifactIdsdk/artifactId version1.0.0/version /dependency只要你的Maven环境配好了镜像和本地仓库这类全新坐标的依赖照样秒下。如果下不动绝大部分原因就是镜像仓库没同步最新索引刷新一下Maven索引或者把mirrorOf改成*就好。另外如果你用的AI编码工具比如Cursor这类需要配Java和Maven它的原理和IDEA一样在设置里指向你本机的JDK路径和Maven路径即可配好以后AI工具生成的Java项目可以直接用Maven跑构建。这个场景越来越常见我顺手提一句。回头看看整个安装流程真正核心的其实就三件事一是选对Maven版本并配好MAVEN_HOME和PATH二是把settings.xml里的本地仓库和镜像换好三是在IDEA里把Maven home和settings文件指对。这三件搞定Maven基本就不会再出什么幺蛾子。我个人实际安装过无数遍的经验是最不值得省时间的就是环境变量配好后那股“诶怎么不生效”的排查过程通常就是新开命令行窗口再试一次的事。至于镜像配置建议第一次就把阿里云镜像配上哪怕你公司有私服也留一个阿里云兜底。每个新人的电脑我都强烈建议装完Maven后先跑一条mvn help:system这一条命令会把大部分基础文件下载一遍确认环境没问题后续再开项目就顺滑多了。