必须先安装JDK并配置JAVA_HOME，再下载解压Maven二进制包到纯英文无空格路径，设置MAVEN_HOME和PATH环境变量，最后通过mvn -v和mvn help:system验证安装并初始化本地仓库。
要在Windows系统上安装Maven构建工具来管理Java项目，必须先确保JDK已正确安装并配置好JAVA_HOME环境变量，否则mvn命令会直接报错退出，连版本检测都无法通过；接着下载二进制压缩包、解压到纯英文无空格路径、设置MAVEN_HOME和PATH，最后验证命令是否可用——整个过程看似简单，但每一步出错都会导致后续构建失败。
确认JDK已安装并配置JAVA_HOME
按下 Win + R，输入 cmd 回车，在命令行中执行：
java -version
若返回类似 java version "17.0.12" 2025-04-15 LTS 的信息，说明JDK已就位；若提示“不是内部或外部命令”，请立即停止后续操作，先安装JDK 17或21 LTS版本。
即使java命令可用，也【必须手动配置JAVA_HOME系统变量】：变量值填JDK安装目录的上一级（如 C:\Program Files\Java\jdk-17.0.12），不能带 \bin；否则Maven启动时可能找不到javac编译器，导致 mvn compile 报“No compiler is provided”错误。
立即学习“Java免费学习笔记（深入）”；
下载并解压Maven二进制包
访问 Maven官方下载页，找到最新稳定版（如 apache-maven-3.9.11-bin.zip），点击 Binary zip archive 链接下载。
将压缩包解压到一个全英文、无空格、无中文字符的路径，例如：D:\apache-maven-3.9.11 或 C:\Tools\maven。绝对不要放在 C:\Program Files 或桌面路径下——路径含空格会导致mvn.cmd脚本解析失败，出现“The system cannot find the path specified”错误。
配置MAVEN_HOME与PATH环境变量
右键“此电脑”→“属性”→“高级系统设置”→“环境变量”。
AI 领域系统学习体系。管理知识图谱、深度学习笔记、实战复盘和关联网络。触发场景：学习计划、知识图谱更新、深度研究某个 AI 主题、实战复盘总结、调研后沉淀知识、每周学习回顾。当用户说'学了什么'、'总结一下'、'沉淀知识'、'复盘'、'更新图谱'、'深入研究'、'写笔记'、'学习回顾'、'review what...
在“系统变量”区域点击“新建”：
变量名：MAVEN_HOME
变量值：【你刚才解压Maven的完整根目录，不含\bin】（如 D:\apache-maven-3.9.11）
再在“系统变量”中找到 Path，点击“编辑”→“新建”，添加：
%MAVEN_HOME%\bin
这一步完成后，所有新打开的命令行窗口才能识别mvn命令；已打开的CMD窗口需关闭重开，否则 mvn -v 仍会提示“不是内部或外部命令”。
验证安装并初始化本地仓库
重新打开一个CMD窗口，执行：
mvn -v
成功时将输出Maven版本、Maven home路径、Java版本及JAVA_HOME路径——三者必须全部显示，缺一不可。
接着运行：
mvn help:system
该命令会触发Maven首次初始化：自动在 C:\Users\用户名\.m2\repository 创建本地仓库目录，并下载基础插件元数据。如果卡在“Downloading from central”且长时间无响应，说明网络不通或未配国内镜像，需跳转至conf/settings.xml修改mirror配置。
