一、前置条件(必须先安装)
在配置 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,组织 / 包名前缀)

