Windows 系统下vscode配置 Maven 的详细步骤

一、下载 Maven

1. 打开浏览器，访问 Maven 官方下载地址：Download Apache Maven – Maven 。
2. 在下载页面中，找到合适的 Maven 版本（建议选择最新稳定版），下载对应的二进制压缩包（一般是.zip格式） 。我选的，如图

   

二、解压 Maven 压缩包

将下载好的压缩包解压到你希望安装 Maven 的目录，例如D:\Program Files\apache-maven-<版本号> ，记住这个解压路径，后续配置会用到。我的是"D:\JAVA\apache-maven-3.9.9"

三、配置环境变量

1. 右键点击 “此电脑”，选择 “属性” 。
2. 在弹出的窗口中，点击 “高级系统设置” 。
3. 在 “系统属性” 窗口的 “高级” 选项卡下，点击 “环境变量” 。
4. 新建MAVEN_HOME系统变量 ：
   • 在 “系统变量” 区域，点击 “新建” 。
   • 在 “变量名” 输入框中输入MAVEN_HOME 。
   • 在 “变量值” 输入框中输入 Maven 的解压路径，例如D:\Program Files\apache-maven-<版本号> 。
   • 点击 “确定” 。
5. 编辑Path系统变量 ：
   • 在 “系统变量” 区域找到Path变量，点击 “编辑” 。
   • 点击 “新建”，然后输入%MAVEN_HOME%\bin 。
   • 点击 “确定” 关闭所有窗口，使环境变量配置生效。

四、验证 Maven 安装

打开命令提示符（Win 键 + R，输入cmd回车），在命令行中输入mvn -v （注意小写），如果出现 Maven 的版本信息，说明 Maven 已成功安装和配置。

五、在 VSCode 中配置 Maven

1. 打开 VSCode，按下快捷键 Ctrl + ,（注意+是和的意思，并不是要按+）， 打开设置界面。
2. 在搜索框中输入 “Maven” ，找到以下配置项：
   • Java > Configuration > Maven: User Settings ：将其设置为 Maven 安装目录下conf文件夹中的settings.xml文件路径，例如D:\Program Files\apache-maven-<版本号>\conf\settings.xml 。我的是D:\JAVA\apache-maven-3.9.9\conf\settings.xml
   • Java > Configuration > Maven: Global Settings ：一般保持为空，使用默认的全局设置。
   • Java > Maven: Download Sources ：可根据需要勾选，用于在导入 Maven 项目时下载依赖的源代码。
   • Java > Maven: Update Snapshots ：可根据需要勾选，用于强制更新快照版本的依赖。
3. 安装Maven for Java扩展：在 VSCode 的扩展商店中搜索并安装该扩展，为在 VSCode 中使用 Maven 提供支持。

六、可选：修改 Maven 依赖下载源（推荐）

打开 Maven 安装目录下conf文件夹中的settings.xml文件，找到<mirrors>标签，在其内部添加镜像配置，例如使用阿里云镜像：

xml

<mirror>
    <id>alimaven</id>
    <name>aliyun maven</name>
    <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
    <mirrorOf>central</mirrorOf>
</mirror>

这样可以加快 Maven 下载依赖的速度。

七、可选：修改 Maven 本地仓库路径

在settings.xml文件中，找到<localRepository>标签（默认被注释掉），将其移到注释之外，并将值改为你想要存放本地仓库的目录，例如：

xml

<localRepository>D:/maven - repository</localRepository>

这样可以避免本地仓库占用 C 盘空间，并且在重装系统时可保留下载的依赖。