必须完成Maven安装、环境变量配置、本地仓库路径重定向和国内镜像切换四步闭环操作;先确认java -version通过,再设JAVA_HOME,解压Maven至纯英文路径,配置MAVEN_HOME与Path,修改settings.xml指定本地仓库并添加阿里云镜像。

要在Windows上让Java项目依赖下载快、构建命令全局可用、本地包不挤占C盘,必须完成Maven安装、环境变量配置、本地仓库路径重定向和国内镜像切换这四步闭环操作。
确认Java环境并设置JAVA_HOME
打开CMD,执行 java -version,看到类似 java version "17.0.12" 的输出才算通过基础校验。若提示“不是内部或外部命令”,说明JDK未安装或PATH未配全,需先解决JDK问题再继续。
即使 java -version 能运行,也必须手动设置 【JAVA_HOME】 系统变量:变量值填JDK根目录(如 C:\Program Files\Java\jdk-17.0.12),注意不能带 \bin 后缀;否则后续 mvn -v 会报错“The JAVA_HOME environment variable is not defined correctly”。
下载解压Maven并规范路径
访问 Maven官方下载页,在 Files 区域下载 apache-maven-3.9.11-bin.zip(2026年最新稳定版)。
解压后将文件夹重命名为不含空格、不含中文的纯英文路径,例如 D:\apache-maven-3.9.11;【绝对禁止放在桌面、文档、下载等系统默认中文路径下】,否则后续执行 mvn 命令时可能因路径编码异常直接失败。
配置MAVEN_HOME与Path环境变量
第一步:新建系统变量 MAVEN_HOME,变量值设为上一步的解压路径(如 D:\apache-maven-3.9.11)。
第二步:编辑系统变量 Path,新增一行:%MAVEN_HOME%\bin。
第三步:关闭所有已打开的CMD窗口,重新打开一个,执行 mvn -v。若看到包含 Maven home 和 Java version 的完整输出,说明环境变量生效。
让 Windows 桌面程序在开机时静默自启并隐藏到系统托盘。特别适用于 Flutter、Electron 等无视 VBS/ProcessStartInfo 窗口样式、难以隐藏的顽固应用。提供「VBS 启动器 + Python ctypes/Win32 API」的隐藏窗口方案,可稳定把窗口收进托盘且不闪控制台。
修改本地仓库路径
方法一:直接编辑安装目录下的 conf\settings.xml
用记事本或VS Code打开 D:\apache-maven-3.9.11\conf\settings.xml,搜索 ,找到被注释掉的默认行(约第55行),在其下方添加新行:。路径可自定义,但必须是已存在的空文件夹——若目录不存在,Maven首次拉包时会静默创建,但可能因权限问题写入失败。
方法二:不改全局配置,改用户级配置(推荐给多账号或多Maven版本用户)
在当前Windows用户目录下创建 .m2\settings.xml(完整路径如 C:\Users\YourName\.m2\settings.xml),把上面那段 写进去即可生效。该文件优先级高于安装目录下的 conf\settings.xml。
配置阿里云镜像加速依赖下载
打开 D:\apache-maven-3.9.11\conf\settings.xml,定位到 标签内部(约第148行起),插入以下配置:
<mirror><br> <id>aliyun-maven</id><br> <name>aliyun maven</name><br> <url>https://maven.aliyun.com/repository/public</url><br> <mirrorof>central</mirrorof><br></mirror>
注意:【 必须小写且无空格,写成 CENTRAL 或 Central 将导致镜像失效】;HTTPS地址已成强制要求,旧的HTTP地址虽仍可访问但存在安全风险,不再推荐。










