VSCode 搭建 Java + Maven 开发环境实战指南
在 VSCode 中配置 Java 和 Maven 环境,核心在于 JDK、Maven 的安装以及插件的协同工作。下面按实际开发流程梳理一遍,确保你少走弯路。
环境准备
工欲善其事,必先利其器。在动手之前,请确认本地已安装以下工具:
- JDK:推荐 JDK 8、11 或 17,Maven 对新版本兼容性较好。
- Maven:从官网下载对应版本(如 apache-maven-3.9.x)。
- 环境变量:
JAVA_HOME指向 JDK 安装目录。MAVEN_HOME指向 Maven 安装目录。- 将
%MAVEN_HOME%\bin和%JAVA_HOME%\bin加入系统 Path。
验证是否生效:打开终端执行 java -version 和 mvn -v,能正常输出版本信息即表示配置成功。
插件与配置
安装必备插件
打开 VSCode 扩展栏(Ctrl+Shift+X),搜索并安装以下核心插件:
- Extension Pack for Java:微软官方扩展包,包含 Java 开发所需的核心工具。
- Maven for Java:支持 pom.xml 编辑、依赖管理及生命周期执行。
- Project Manager for Java(可选):方便在多项目间快速切换。
指定运行路径
如果 VSCode 未能自动识别 JDK 或 Maven 路径,需手动配置。打开设置(Ctrl+,),找到 settings.json 进行编辑。
添加 JDK 配置示例(以 JDK 11 为例):
"java.configuration.runtimes": [
{
"name": "JavaSE-11",
"path": "D:\\jdk-11.0.19",
"default": true
}
]
接着配置 Maven 可执行文件路径:
"maven.executable.path": "D:\\apache-maven-3.9.6\\bin\\mvn.cmd"
如需自定义镜像或仓库,还可设置 settings.xml 路径:

