一、前置条件（必须先安装）
在配置 VSCode 的 Maven 环境前，需要先安装好以下工具：
- JDK（推荐 JDK 8/11/17，Maven 对新版本 JDK 兼容性较好）
- Maven（官网下载 apache-maven-3.6+ 版本）
- 配置环境变量：
- 配置 JAVA_HOME（指向 JDK 安装目录）
- 配置 MAVEN_HOME（指向 Maven 安装目录）
- 把 %MAVEN_HOME%\bin 和 %JAVA_HOME%\bin 添加到系统 Path 中
- 验证：打开终端执行 java -version 和 mvn -v，能正常输出版本信息即配置成功。
二、VSCode 配置步骤
1. 安装必备插件
打开 VSCode，在左侧扩展栏（Ctrl+Shift+X）搜索并安装以下插件：
- Extension Pack for Java（微软官方 Java 扩展包，包含核心的 Java 开发工具）
- Maven for Java（专门支持 Maven 项目的插件，提供 pom.xml 编辑、依赖管理、生命周期执行等功能）
- Project Manager for Java（可选，方便管理多个 Java/Maven 项目）
2. 配置 VSCode 的 Java/Maven 路径（可选，自动识别失败时手动配置）
如果 VSCode 没有自动识别 JDK/Maven 路径，需要手动配置：
打开 VSCode 设置（Ctrl+,），搜索 java.configuration.runtimes，点击「编辑 in settings.json」。
添加 JDK 配置（示例为 JDK 11）：
"java.configuration.runtimes": [ { "name": "JavaSE-11", "path": "你的 JDK 安装路径（如 D:\jdk-11.0.19）", "default": true } ]
搜索 maven.executable.path，设置 Maven 可执行文件路径（如 D:\apache-maven-3.9.6\bin\mvn.cmd）。
搜索 maven.settings.file，可选配置 Maven 的 settings.xml 路径（如 D:\apache-maven-3.9.6\conf\settings.xml，用于配置镜像、本地仓库等）。
3. 创建 / 打开 Maven 项目
方式 1：创建新的 Maven 项目
打开 VSCode 命令面板（Ctrl+Shift+P），输入 Maven: Create Maven Project，回车。
选择 Maven Archetype（推荐 maven-archetype-quickstart，基础 Java 项目模板）。
选择 Archetype 版本（直接回车选最新即可）。
输入项目信息：
- Group Id（如 com.example，组织 / 包名前缀）
- Artifact Id（如 maven-demo，项目名）
- Version（默认 1.0-SNAPSHOT，回车即可）
- Package（默认和 Group Id 一致，回车即可）
选择项目保存路径，等待 Maven 自动生成项目结构。
方式 2：打开已有的 Maven 项目
点击 VSCode 左侧「文件」→「打开文件夹」，选择 Maven 项目的根目录（包含 pom.xml 的目录）。
VSCode 会自动识别 Maven 项目，并加载依赖（首次加载可能需要几分钟，耐心等待）。
4. 验证环境是否正常
打开项目中的 src/main/java/com/example/App.java（自动生成的测试类）。
右键点击文件，选择「Run Java」，终端会输出 Hello World!，说明运行正常。
验证 Maven 命令：打开 VSCode 终端（Ctrl+`），执行 mvn clean package，能成功打包生成 target/ 目录，说明 Maven 命令执行正常。
三、优化配置（可选，提升开发体验）
配置 Maven 镜像（加速依赖下载）：
编辑 Maven 的 settings.xml（路径：MAVEN_HOME/conf/settings.xml），添加阿里云镜像：
<mirrors>
<mirror>
<id>aliyunmaven</id>
<mirrorOf>central</mirrorOf>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>
设置本地仓库路径：
在 settings.xml 中添加：
<localRepository>D:\maven-repo</localRepository>
总结
- 搭建核心：先安装并配置 JDK 和 Maven 的环境变量，再给 VSCode 装 Java 和 Maven 插件。
- 关键验证：通过「创建 Maven 项目 + 运行测试类 + 执行 mvn 命令」确认环境可用。
- 优化点：配置阿里云 Maven 镜像可大幅提升依赖下载速度，是必做的优化项。
整个过程完成后，你就可以在 VSCode 中正常开发、编译、打包 Java Maven 项目了。如果遇到依赖加载慢、插件识别失败等问题，优先检查环境变量和 VSCode 的 settings.json 配置是否正确。