1. 为什么Maven 3.6.3依然是许多项目的“定海神针”如果你刚接触Java开发或者接手了一个有些年头的项目打开项目根目录下的pom.xml文件很可能会在构建日志或文档里看到对Maven 3.6.3的依赖。你也许会疑惑现在Maven都更新到3.9.x了为什么还要费劲去安装一个“老版本”这恰恰是Maven 3.6.3的特殊之处它不是一个普通的旧版本而是一个在Java生态中承上启下、极其稳定的“长期支持”版本。许多成熟的企业级项目、开源框架比如Spring Boot 2.x的许多版本都将其作为官方推荐或兼容的构建工具版本。盲目使用最新版Maven有时反而会遭遇依赖解析策略变更、插件不兼容等“惊喜”。因此掌握Maven 3.6.3的安装与配置不是学习过时的知识而是掌握一项与大量现存项目和平共处的实用技能。本文将手把手带你完成从零开始的下载、安装、配置到验证的全过程并分享几个只有踩过坑才知道的关键配置技巧。2. 前期准备理清JDK与Maven的“共生关系”在下载Maven之前有一个比下载本身更重要的前提必须确认那就是Java开发工具包JDK。Maven本身是用Java编写的工具它的运行完全依赖于JDK。这里有一个常见的认知误区我电脑上能运行java -version不就行了吗实际上对于Maven 3.6.3我们需要更精确的匹配。2.1 确认并安装兼容的JDK版本Maven 3.6.3官方要求至少JDK 7但强烈建议使用JDK 8或以上版本以获得最佳性能和兼容性。在实际开发中JDK 8和JDK 11是与之搭配最广泛的组合。打开你的终端Windows上是CMD或PowerShellmacOS/Linux上是Terminal输入以下命令检查java -version你期望看到的输出应该类似于java version 1.8.0_301 Java(TM) SE Runtime Environment (build 1.8.0_301-b09) Java HotSpot(TM) 64-Bit Server VM (build 25.301-b09, mixed mode)或者对于JDK 11openjdk version 11.0.15 2022-04-19 OpenJDK Runtime Environment Temurin-11.0.1510 (build 11.0.1510) OpenJDK 64-Bit Server VM Temurin-11.0.1510 (build 11.0.1510, mixed mode)如果显示“不是内部或外部命令”说明你需要先安装JDK。建议从Adoptium原AdoptOpenJDK或Oracle官网下载JDK 8或JDK 11的安装包进行安装。安装后最关键的一步是配置JAVA_HOME环境变量。JAVA_HOME应该指向你的JDK安装根目录而不是bin目录也不是JRE目录。Windows示例如果你的JDK安装在C:\Program Files\Java\jdk1.8.0_301那么JAVA_HOME就应该是这个路径。macOS/Linux示例如果你通过Homebrew安装路径可能类似/Library/Java/JavaVirtualMachines/temurin-11.jdk/Contents/Home。配置完成后重新打开终端再次执行java -version和javac -version后者检查编译器以确保配置正确。这是Maven能否顺利运行的基石很多安装后报错“找不到JAVA_HOME”的根源都在这里。2.2 规划Maven的安装目录和JDK一样为Maven选择一个“安家”的目录。建议选择一个路径简单、没有中文和空格的目录方便后续配置。Windows例如D:\Development\apache-maven-3.6.3macOS/Linux例如/usr/local/apache-maven-3.6.3或~/Development/apache-maven-3.6.3~代表用户主目录。这个目录将用来存放你接下来下载并解压的Maven全部文件。3. 从官方渠道获取Maven 3.6.3二进制包网络上充斥着各种打包的、带广告的所谓“一键安装包”为了安全和纯净强烈建议从Apache官方镜像站下载。这里以Windows系统为例macOS和Linux的.tar.gz包下载流程类似。3.1 访问Apache Maven官方下载页打开浏览器访问 Apache Maven 官方项目页面。通常搜索引擎直接搜索“Apache Maven”第一个结果就是。在官网找到“Download”部分你会看到最新版本。我们需要的是历史版本。找到“Archives”或“Previous Releases”链接点击进入。在存档列表中找到3.6.3这个版本。你会看到两个主要的二进制发布包apache-maven-3.6.3-bin.zip适用于Windows系统。apache-maven-3.6.3-bin.tar.gz适用于macOS和Linux系统。点击对应的链接进行下载。官方页面会列出全球的镜像站点选择一个地理位置离你较近的镜像例如在国内可以选择清华大学的镜像站速度会快很多。直接点击镜像链接即可开始下载。注意务必下载-bin二进制版本而不是-src源代码版本。我们只需要运行它而不是编译它。3.2 解压到指定安装目录下载完成后你将获得一个压缩包。Windows右键点击apache-maven-3.6.3-bin.zip选择“解压到当前文件夹”或使用解压软件解压。然后将解压出的apache-maven-3.6.3文件夹移动到你在步骤2.2中规划的目录下例如D:\Development\。最终路径应为D:\Development\apache-maven-3.6.3。macOS/Linux打开终端进入下载目录执行以下命令假设你计划安装到/usr/localsudo tar -xzf apache-maven-3.6.3-bin.tar.gz -C /usr/local/解压后你可以在/usr/local/apache-maven-3.6.3找到所有文件。现在Maven的所有可执行文件都在你安装目录的bin子文件夹里了。但是你无法在系统的任何地方直接调用它们除非我们进行下一步——配置环境变量。4. 配置系统环境变量让mvn命令随处可用环境变量的配置是打通Maven与操作系统命令行的关键。我们需要配置两个变量MAVEN_HOME或M2_HOME和将Maven的bin目录添加到PATH中。4.1 Windows系统配置详解设置 MAVEN_HOME右键点击“此电脑”或“计算机”选择“属性”。点击“高级系统设置”。在弹出的“系统属性”窗口中点击“环境变量”按钮。在“系统变量”区域如果想对所有用户生效或“用户变量”区域仅对当前用户生效点击“新建”。变量名输入MAVEN_HOME或M2_HOME两者任选其一但MAVEN_HOME更通用。变量值输入你的Maven安装目录的绝对路径例如D:\Development\apache-maven-3.6.3。务必确保路径正确不要包含bin子目录也不要有多余的空格或分号。编辑 Path 变量在“系统变量”或“用户变量”区域找到名为Path的变量选中并点击“编辑”。在编辑环境变量窗口中点击“新建”然后添加一行新条目%MAVEN_HOME%\bin。如果你使用的是Windows 10之前的版本Path变量是一个用分号分隔的字符串你需要在末尾添加;%MAVEN_HOME%\bin。点击“确定”保存所有更改。4.2 macOS / Linux 系统配置详解以bash或zsh为例通常我们需要修改用户主目录下的 shell 配置文件如~/.bashrc、~/.bash_profile或~/.zshrc如果你使用zsh。打开终端使用文本编辑器如nano或vim打开配置文件。例如对于bashnano ~/.bash_profile或对于zshnano ~/.zshrc在文件末尾添加以下几行# 设置 MAVEN_HOME export MAVEN_HOME/usr/local/apache-maven-3.6.3 # 将 Maven 的 bin 目录添加到 PATH export PATH$MAVEN_HOME/bin:$PATH请将/usr/local/apache-maven-3.6.3替换为你实际的Maven安装路径。保存并退出编辑器在nano中按CtrlX然后按Y确认再按回车。让配置立即生效执行以下命令之一具体取决于你修改的文件。source ~/.bash_profile # 或 source ~/.zshrc4.3 验证环境变量配置配置完成后务必关闭所有现有的终端或命令提示符窗口然后重新打开一个新的。这是为了让新的环境变量加载生效。在新的终端中输入以下命令mvn -v或者mvn --version如果一切配置正确你将看到类似以下的输出其中包含了Maven版本、你的JDK版本和操作系统信息Apache Maven 3.6.3 (cecedd343002696d0abb50b32b541b8a6ba2883f) Maven home: D:\Development\apache-maven-3.6.3 Java version: 1.8.0_301, vendor: Oracle Corporation, runtime: C:\Program Files\Java\jdk1.8.0_301\jre Default locale: zh_CN, platform encoding: GBK OS name: windows 10, version: 10.0, arch: amd64, family: windows看到这个恭喜你Maven的核心安装已经成功了但这只是第一步要让Maven好用接下来的配置才是精髓。5. 深度配置让Maven在中国飞起来默认情况下Maven会从位于国外的中央仓库Maven Central Repository下载依赖jar包。对于国内开发者来说这往往意味着缓慢的下载速度甚至超时失败。因此配置一个国内镜像仓库是安装后必须立即进行的操作。5.1 定位并修改Maven的settings.xml文件Maven的全局配置文件位于其安装目录的conf文件夹内名为settings.xml。我们即将修改它。路径示例D:\Development\apache-maven-3.6.3\conf\settings.xml在编辑之前我强烈建议你先备份这个原始文件。然后用任何文本编辑器如VS Code、Notepad、Sublime Text打开它。5.2 配置阿里云Maven镜像仓库在settings.xml文件中找到mirrors标签部分。默认情况下它可能是空的或者被注释掉。我们需要在mirrors标签内添加一个镜像配置。将以下配置片段添加到mirrors标签内部mirror idaliyunmaven/id mirrorOf*/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror这段配置的含义是id镜像的唯一标识符可以自定义。mirrorOf*/mirrorOf这是关键。*表示匹配所有仓库包括中央仓库central任何对原始仓库的下载请求都会被重定向到这个阿里云镜像。这能极大加速所有依赖的下载。name镜像的描述名称。url阿里云提供的公共Maven仓库地址。5.3 可选但推荐修改本地仓库位置Maven会将下载的所有依赖jar包、插件等缓存到本地一个叫做“本地仓库”的目录。默认路径是用户主目录下的.m2/repository例如Windows上是C:\Users\你的用户名\.m2\repository。随着项目增多这个目录会变得非常庞大有时你可能希望把它放在空间更大的磁盘上。同样在settings.xml文件中找到localRepository标签。默认它是被注释的。你可以取消注释并修改其值localRepositoryD:\Development\maven-repository/localRepository将路径D:\Development\maven-repository替换为你希望存放本地仓库的实际路径。确保该路径存在或者Maven会在首次运行时自动创建它。5.4 验证镜像配置是否生效保存settings.xml文件。打开终端随意找一个Maven项目目录或者新建一个临时目录在里面执行一个会触发下载的命令例如mvn help:system这个命令会下载一些基本的插件和依赖。观察下载日志如果看到下载地址从repo.maven.apache.org变成了maven.aliyun.com就说明镜像配置成功了。首次运行可能会下载一些元数据速度会明显快于连接国外仓库。6. 集成到IDE在IntelliJ IDEA中配置Maven对于大多数Java开发者我们是在集成开发环境IDE中使用Maven而不是命令行。这里以最流行的IntelliJ IDEA为例。打开设置打开IntelliJ IDEA进入File-SettingsWindows/Linux或IntelliJ IDEA-PreferencesmacOS。定位Maven配置在设置窗口中导航到Build, Execution, Deployment-Build Tools-Maven。配置Maven主目录在“Maven home path”右侧点击文件夹图标浏览并选择你安装的Maven 3.6.3的根目录例如D:\Development\apache-maven-3.6.3。IDEA会自动识别并填充“User settings file”和“Local repository”的路径它们应该指向你刚才修改的settings.xml和你配置的本地仓库路径。请务必核对这两个路径是否正确尤其是“User settings file”是否指向了你修改过的那个settings.xml。配置Runner重要点击“Runner”选项卡。这里有一个关键设置“VM Options”。对于Maven 3.6.3特别是当你的项目依赖较多或网络环境复杂时建议添加以下参数来避免内存不足和编码问题-Xms512m -Xmx1024m -Dfile.encodingUTF-8-Xms和-Xmx设置了Maven运行时的初始堆内存和最大堆内存。-Dfile.encodingUTF-8确保构建过程中的文件编码一致避免中文乱码。点击“OK”或“Apply”保存配置。现在在IDEA中打开或导入一个Maven项目pom.xml文件IDEA会自动识别并开始根据你的配置下载依赖、构建项目。你可以在IDEA右侧的“Maven”工具窗口中看到所有生命周期命令和插件并可以图形化地执行它们。7. 实战验证与常见问题排查安装配置完成后最好的验证方式就是实际运行一个Maven命令。7.1 创建一个简单的Maven项目打开终端进入一个你准备存放代码的目录执行以下命令mvn archetype:generate -DgroupIdcom.example -DartifactIdmy-first-app -DarchetypeArtifactIdmaven-archetype-quickstart -DinteractiveModefalse这个命令使用Maven的“项目原型”功能快速生成一个标准的Java项目骨架。它会下载必要的原型插件和依赖此时就能检验你的镜像仓库是否工作正常。命令执行成功后当前目录下会生成一个名为my-first-app的文件夹。进入该文件夹执行编译命令cd my-first-app mvn clean compile如果看到BUILD SUCCESS的输出说明你的Maven环境已经完全就绪可以正常编译项目了。7.2 典型问题与解决方案即使按照教程一步步操作也可能会遇到一些问题。这里列举几个最常见的‘mvn‘ 不是内部或外部命令也不是可运行的程序原因PATH环境变量未正确配置或者配置后未重启终端。解决首先在终端中执行echo %MAVEN_HOME%Windows或echo $MAVEN_HOMEmacOS/Linux检查是否能正确输出路径。如果不能说明MAVEN_HOME变量设置有问题。如果能检查PATH变量中是否包含了%MAVEN_HOME%\bin或$MAVEN_HOME/bin。最后务必关闭所有终端窗口重新打开。JAVA_HOME should point to a JDK not a JRE原因JAVA_HOME环境变量指向了JREJava运行时环境的目录而不是JDKJava开发工具包的目录。解决重新检查JAVA_HOME的路径。它应该指向类似C:\Program Files\Java\jdk1.8.0_xxx或/Library/Java/JavaVirtualMachines/jdk-11.x.x.jdk/Contents/Home的目录其下应有bin,jre,lib等子文件夹。如果指向了.../jre将其更正为上一级的JDK目录。依赖下载极其缓慢或失败原因未正确配置国内镜像或者settings.xml文件未被IDE识别。解决首先确认命令行执行mvn -v时使用的Maven home路径然后去该路径下的conf/settings.xml检查镜像配置。其次在IDE如IDEA中务必在Maven设置里确认“User settings file”指向的是你修改过的那个settings.xml文件而不是默认的或另一个位置的。构建失败提示插件或依赖找不到Could not find artifact原因可能是本地仓库损坏或者镜像仓库中确实没有该特定版本的构件。解决尝试删除本地仓库中对应的依赖目录在.m2/repository下找到对应的groupId/artifactId路径删除整个版本文件夹然后重新构建。如果问题依旧检查pom.xml中依赖的版本号是否写错或者尝试在 https://mvnrepository.com/ 上搜索该依赖确认其坐标和版本是否存在。Maven 3.6.3的安装本身并不复杂但围绕它的环境配置却是保证后续开发体验顺畅的关键。花些时间理解JAVA_HOME、PATH、settings.xml以及IDE配置之间的联动关系远比机械地执行步骤更重要。一旦这套环境配通它将成为你处理绝大多数Java项目时稳定可靠的基石。