首先安装Java Platform Extension Pack、Maven for Java和Gradle for Java插件,然后配置JDK路径至Java: Home设置项,确保系统环境变量JAVA_HOME和构建工具(Maven/Gradle)已正确安装并加入PATH,最后通过侧边栏Maven或Gradle视图管理项目依赖与任务,即可实现完整开发支持。

配置 VSCode 的 Java 开发环境并支持 Maven 与 Gradle 项目,关键在于安装必要的插件和正确设置 JDK、构建工具路径。只要步骤清晰,整个过程并不复杂。
安装核心插件
打开 VSCode,进入扩展市场(Extensions),搜索并安装以下插件:
- Java Platform Extension Pack:包含语言支持、调试器、测试支持等基础功能
- Maven for Java:提供 Maven 项目管理、依赖查看、生命周期操作支持
- Gradle for Java:支持 Gradle 项目的导入、任务执行和依赖管理
这些插件由 Microsoft 官方维护,兼容性好,能自动识别项目类型并激活相应功能。
配置 JDK 环境
Java 项目运行依赖 JDK,VSCode 需要明确知道其安装位置。
立即学习“Java免费学习笔记(深入)”;
- 确保已安装 JDK(推荐使用 OpenJDK 11 或 17)
- 在系统中设置 JAVA_HOME 环境变量,指向 JDK 安装目录
- 在 VSCode 中按下 Ctrl + , 打开设置,搜索 "java home",在 Java: Home 配置项中填写 JDK 路径,例如:C:\Program Files\Java\jdk-17
配置完成后,新建或打开一个 Java 文件,应能看到语法高亮和代码提示,说明环境已生效。
Maven 项目支持
VSCode 可直接打开含 pom.xml 的文件夹作为 Maven 项目。
- 确保系统已安装 Maven,并将 mvn 添加到环境变量 PATH
- 打开项目后,左侧活动栏会出现 Maven 图标,点击可查看项目依赖、插件和可执行的生命周期命令(如 compile、test、package)
- 双击命令即可运行,也可右键选择“在终端中运行”
若依赖未自动下载,可在项目根目录打开终端,手动执行 mvn compile 触发依赖解析。
Gradle 项目支持
类似 Maven,VSCode 支持通过 build.gradle 识别 Gradle 项目。
- 确保已安装 Gradle,或将项目中的 Gradle Wrapper(gradlew)设为默认工具
- 打开项目后,Gradle 插件会自动扫描并显示任务树,位于侧边栏的 Gradle 视图中
- 可展开任务类别(如 build、test),点击运行对应任务
- 首次加载可能较慢,因需下载依赖和初始化项目模型
如果任务未显示,尝试右键项目根目录,选择“Refresh Gradle Project”重新加载。
基本上就这些。配置完成后,无论是 Maven 还是 Gradle 项目,都能在 VSCode 中实现编码、构建、调试全流程。关键是插件到位、JDK 明确、构建工具可用。不复杂但容易忽略细节。










