在VS Code中搭建Java开发环境（从JDK到Maven/Gradle）

VS Code 搭建 Java 开发环境需配置 JDK、Java 扩展包和 Maven/Gradle 构建工具；安装 JDK 并设置 JAVA_HOME 和 PATH，安装 Extension Pack for Java，用命令行初始化项目，再通过右上角按钮运行或 F5 调试。

在 VS Code 中搭建 Java 开发环境，核心是配齐三样东西：JDK（运行和编译基础）、Java 扩展包（语言支持）、构建工具（Maven 或 Gradle）。不装 IDE（如 IntelliJ），也能高效写 Java —— 关键是配置到位、路径清晰、插件选对。

1. 安装并配置 JDK

JDK 是 Java 开发的起点。推荐使用 Adoptium Temurin（开源、免费、主流厂商维护）或 Oracle JDK（需注意许可条款）。不要用 JRE，它不能编译代码。

• 下载安装包（如 JDK 17 或 21 LTS 版本），运行安装，记住安装路径（例如：C:\Program Files\Eclipse Adoptium\jdk-17.0.1-hotspot 或 /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home）
• 设置系统环境变量：JAVA_HOME 指向 JDK 根目录（不是 bin 子目录），并把 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（macOS/Linux）加入 PATH
• 终端中执行 java -version 和 javac -version，确认输出一致且版本正确

2. 安装 VS Code Java 扩展包

VS Code 本身不识别 Java，靠扩展提供智能提示、调试、项目管理等功能。官方推荐一套组合：

• Extension Pack for Java（微软官方打包）—— 一键安装，含 Language Support for Java、Debugger for Java、Test Runner for Java、Project Manager for Java、Maven for Java 等核心组件
• 重启 VS Code 后，打开一个 .java 文件，底部状态栏应显示 JDK 版本；若提示“Java runtime not found”，点击提示或进入设置（Settings → Java → Configuration → JDK）手动指定 JAVA_HOME

3. 初始化项目并接入 Maven 或 Gradle

VS Code 不自带新建 Java 项目向导，但可通过命令行 + 扩展快速生成标准结构。

帮小忙

腾讯QQ浏览器在线工具箱平台

102

查看详情

立即学习“Java免费学习笔记（深入）”；

• Maven 方式：确保已安装 Maven（配置好 M2_HOME 和 PATH），终端进入空文件夹，运行：
  mvn archetype:generate -DgroupId=com.example -DartifactId=myapp -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
  然后在 VS Code 中打开该文件夹，自动识别为 Maven 项目（左侧会显示 Maven 侧边栏）
• Gradle 方式：安装 Gradle（或用 Gradle Wrapper），运行：
  gradle init --type java-application
  打开文件夹后，Java 扩展会检测 build.gradle 并激活 Gradle 支持（需装 Gradle for Java 扩展可增强体验）
• 无论哪种，首次加载可能需要几秒下载依赖索引 —— 看右下角状态栏“Java Language Server”进度即可

4. 运行与调试不踩坑

写完 main 方法后，别急着右键“Run”，先确认几个关键点：

• 确保当前文件是 .java 且类含 public static void main(String[] args)
• 点击编辑器右上角 ▶️ 按钮（或按 Ctrl+F5），VS Code 会自动生成 .vscode/launch.json 配置，选择 “Java” 环境即可启动
• 调试时打断点，F5 启动调试模式；如果报 “class not found”，检查 src/main/java 是否被正确识别为源码根目录（右键文件夹 → “Mark as Sources Root”）
• Maven/Gradle 构建任务可绑定到快捷键：打开命令面板（Ctrl+Shift+P），输入 “Tasks: Run Task”，选 “maven clean compile” 或 “gradle build”

基本上就这些。不复杂但容易忽略细节 —— 尤其是 JAVA_HOME 路径、扩展是否启用、源码目录标记。配好一次，后续新建项目基本复用同一套环境。

以上就是在VS Code中搭建Java开发环境（从JDK到Maven/Gradle）的详细内容，更多请关注php中文网其它相关文章！