安装 JDK 并配置 环境变量 ,再在vscode 中安装 java 扩展包,接着配置 maven 或gradle构建 工具,最后通过命令面板创建或导入项目即可完成开发环境搭建。

要在 VSCode 中搭建完整的 Java 开发环境,支持 Maven 或 Gradle 项目,只需安装必要的插件并配置好相关 工具 链。整个过程不复杂,关键是确保 Java、构建工具和编辑器之间的协作正常。
1. 安装 Java Development Kit (JDK)
Java 开发的前提是安装 JDK。推荐使用 LTS 版本,如 JDK 11 或 JDK 17。
- 前往 Eclipse Adoptium 下载并安装 JDK
- 设置 环境变量 :JAVA_HOME 指向 JDK 安装路径,并将bin 目录加入系统 PATH
- 验证安装:打开终端执行
java -version和javac -version
2. 安装 VSCode 与核心 Java 插件
VSCode 本身不支持 Java 语法和调试,需依赖插件扩展功能。
- 下载并安装Visual Studio Code
- 在扩展市场搜索并安装以下插件:
- 该插件包会自动引入 Java Language Support、Debugger for Java、Test Runner 等关键组件
3. 配置 Maven 或 Gradle
VSCode 通过插件支持 Maven 和 Gradle 项目管理,无需额外配置即可识别标准结构。
立即学习“Java 免费学习笔记(深入)”;
Maven 设置
- 确保已安装 Maven:从 Apache Maven 官网 下载并 解压
- 配置环境变量:MAVEN_HOME 指向 Maven 根目录,将 bin 加入 PATH
- 验证:终端运行
mvn -v - 在 VSCode 中打开一个
pom.xml文件,左侧活动栏会出现 Maven 图标,可查看依赖和生命周期命令
Gradle 设置
- 推荐使用 Gradle Wrapper(
gradlew),避免手动安装 - 若需全局安装,参考Gradle 安装指南
- VSCode 打开含
build.gradle的项目后,Gradle Tasks 会出现在左侧边栏 - 点击即可执行构建、测试、运行等任务
4. 创建和导入 Java 项目
你可以新建项目或导入现有 Maven/Gradle 工程。
- 按下 Ctrl+Shift+P 打开命令面板
- 输入“Java: Create a Java project”并选择
- 选择构建工具(Maven 或 Gradle)
- 按提示选择项目路径、组 ID、工件 ID 等信息
- VSCode 会自动生成标准目录结构和 配置文件
对于已有项目,直接使用“File > Open Folder”打开项目根目录即可。
5. 编写、构建与运行代码
环境就绪后,开发流程顺畅。
- 打开
.java文件,VSCode 提供智能补全、错误提示、快速修复 - 右键代码可运行单个类(需包含 m ai n 方法)
- Maven 项目可用 Maven 侧边栏执行
compile、test、package - Gradle 项目通过 Gradle 侧边栏执行对应任务
- 调试时点击代码行号设断点,然后点击“Run and Debug”启动调试会话
基本上就这些。只要 JDK、Maven/Gradle 配置正确,加上官方 Java 插件支持,VSCode 就能胜任日常 Java 开发工作。不需要繁琐设置,适合轻量级或学习用途。