Windows 下 Maven 安装与 VSCode 配置

Windows 下 Maven 安装与 VSCode 配置全通关教程

虽然 VSCode 的 Java 插件内置了 Maven，但在实际开发中，独立安装 Maven 是标准操作。它能让你在终端使用命令行、配置国内镜像提速、并把动辄十几 G 的依赖包从 C 盘拯救出来。

第一阶段：下载与系统环境配置

1. 下载 Maven

前往 Apache Maven 官网下载页。
找到 Files 区域，下载 bin.zip 结尾的压缩包（如 apache-maven-3.9.x-bin.zip）。

2. 解压文件

将下载的压缩包解压到你的电脑里。
⚠️ 重要提醒 ：安装路径中绝对不能包含中文和空格。
推荐路径示例 ：D:\maven\apache-maven-3.9.x

3. 配置 Windows 环境变量

按下 Win 键，搜索"环境变量"，点击"编辑系统环境变量"。
在弹出的窗口点击底部的"环境变量"按钮。
在下方的"系统变量 "区域，点击"新建"：
- 变量名：MAVEN_HOME
- 变量值：你的 Maven 解压目录（例如 D:\maven\apache-maven-3.9.x）
找到系统变量中的 Path，双击编辑，点击"新建"，输入 %MAVEN_HOME%\bin，然后一路点击"确定"保存。

4. 验证安装

打开命令提示符（CMD）或 PowerShell，输入 mvn -v。
如果能打印出 Maven 的版本号和 Java 的路径信息，说明环境变量配置成功！

第二阶段：修改核心配置（提速 + 拯救 C 盘）

进入你刚才解压的 Maven 目录，打开 conf 文件夹，找到 settings.xml。

(💡 建议：修改前先复制一份命名为 settings.xml.bak 作为备份。)

用记事本或 VSCode 打开 settings.xml，进行以下三项核心修改：

1. 修改本地仓库路径（把包存到 D 盘）

默认情况依赖包会塞满 C 盘。我们需要自定义一个位置。

找到被注释掉的 <localRepository>/path/to/local/repo</localRepository>。
在它下方 ，添加你的 D 盘新路径（注意路径使用正斜杠 /）：
xml 复制代码
```
<localRepository>D:/maven/repository</localRepository>
```

2. 配置阿里云镜像（解决下载极慢的问题）

往下划，找到 <mirrors> 和 </mirrors> 标签（注意带 s）。

在它们中间插入阿里云源：

xml 复制代码

<mirrors>
  <mirror>
    <id>aliyunmaven</id>
    <mirrorOf>central</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
  </mirror>
</mirrors>

(注意：如果里面已经有其他的 <mirror>，请把阿里云的放在最上面，或者把其他的注释掉，确保阿里云生效。)

3. 配置全局默认 JDK 版本（防止编译报错）

如果你不配置，有些 Maven 插件会默认使用非常古老的 JDK 1.5 语法进行编译，导致报错。我们可以在这里锁死默认 JDK 版本。

往下划，找到 <profiles> 和 </profiles> 标签。

在它们中间插入你当前使用的 JDK 版本配置（以 JDK 17 为例，如果你用 JDK 8，就把 17 全改成 8）：

xml 复制代码

<profiles>
  <profile>
    <id>jdk-17</id>
    <activation>
      <activeByDefault>true</activeByDefault>
      <jdk>17</jdk>
    </activation>
    <properties>
      <maven.compiler.source>17</maven.compiler.source>
      <maven.compiler.target>17</maven.compiler.target>
      <maven.compiler.compilerVersion>17</maven.compiler.compilerVersion>
    </properties>
  </profile>
</profiles>

保存并关闭 settings.xml。

第三阶段：C 盘大瘦身（迁移旧依赖包）

如果你之前已经用 VSCode 写过 Java，你的 C 盘 C:\Users\你的用户名\.m2\repository 目录下肯定已经缓存了大量依赖包。

如何处理旧包？（强烈推荐"搬家法"）

打开 C:\Users\你的用户名\.m2 目录。
找到 repository 文件夹，进入该文件夹，全选里面的所有内容并剪切。
打开你刚刚在配置文件里设置的新仓库路径（如 D:\maven\repository），粘贴进去。
旧的 .m2 文件夹保留即可，不用整个删除，因为某些 Java 工具偶尔还需要用到这个默认空目录。

这样做的好处是：C 盘空间腾出来了，且之前的包无缝迁移，下次打开项目无需重新下载，实现秒开！

第四阶段：与 VSCode 完美集成

最后一步，我们需要告诉 VSCode 去使用我们刚刚精心配置好的系统 Maven。

打开 VSCode，按下快捷键 Ctrl + ,（逗号）打开设置。
在顶部搜索框输入 maven。
找到以下两个关键配置，填入你的绝对路径：
- Maven > Executable: Path
  填入：D:\maven\apache-maven-3.9.x\bin\mvn.cmd（指向你的 mvn 启动脚本）
- Java > Configuration > Maven: User Settings
  填入：D:\maven\apache-maven-3.9.x\conf\settings.xml（指向你刚才修改好的配置文件）

🎉 最终测试

在 VSCode 中打开终端（Ctrl + ~），输入以下命令测试完整环境：

bash 复制代码

mvn help:system

成功的标志：

终端一开始会打印类似 Downloading from aliyunmaven: https://maven.aliyun.com/...，说明阿里云镜像已生效。
等待它执行完毕（出现 BUILD SUCCESS），去你的 D:\maven\repository 目录下看一眼，发现里面多了几个新下载的文件夹，说明本地仓库路径已生效。

至此，你的 Windows + VSCode + Maven 开发环境已经达到了企业级的最佳实践状态。