在 VS Code 中配置 Java 开发与调试环境的关键是安装 Java Extension Pack 扩展、正确配置 JDK 路径、使用 Maven 创建标准项目结构,并通过断点和运行命令实现调试与执行。

在 VS Code 中配置 Java 开发与调试环境不难,关键是装对扩展、配好 JDK 路径、理解项目结构。只要 JDK 已安装,其余步骤几分钟就能完成。
安装必要扩展
VS Code 本身不支持 Java,需通过扩展补全功能:
- Extension Pack for Java(微软官方推荐):一键安装包含 Java Extension、Debugger for Java、Test Runner for Java 等核心组件
- Project Manager for Java(可选):方便快速切换多个 Java 项目
- 如果用 Maven,再装 Maven for Java;用 Gradle 可装 Gradle for Java
打开扩展面板(Ctrl+Shift+X),搜“Java Extension Pack”,点击安装并重启 VS Code。
确认并配置 JDK
VS Code 需要知道你本地 JDK 的位置。它会自动探测常见路径(如 $JAVA_HOME 或系统 PATH 中的 java),但有时需要手动指定:
立即学习“Java免费学习笔记(深入)”;
- 按 Ctrl+Shift+P 打开命令面板,输入 Java: Configure Java Runtime
- 在 “Java Runtime” 标签下,检查已识别的 JDK 版本;若为空或错误,点击 Add JDK
- 浏览到 JDK 安装目录(例如
C:\Program Files\Java\jdk-17或/usr/lib/jvm/java-17-openjdk) - 保存后,底部状态栏应显示当前使用的 Java 版本(如 “Java 17”)
创建或打开 Java 项目
VS Code 不强制要求 Maven/Gradle,但推荐使用——便于依赖管理和构建:
- 新建空文件夹,用 VS Code 打开
- 按 Ctrl+Shift+P → 输入 Java: Create Java Project,选择 no build tools(纯 Java)或 Maven(推荐)
- 填写 GroupId(如
com.example)、ArtifactId(项目名),回车生成标准结构 - 源码默认放在
src/main/java,类文件需符合包路径(如com.example.HelloWorld对应src/main/java/com/example/HelloWorld.java)
若已有传统结构(含 .class 文件),可右键文件夹 → Java: Add Folder to Java Classpath,但不建议长期这么做。
运行与调试 Java 程序
写好 main 方法后,调试非常直观:
- 在代码行号左侧灰色区域单击设断点(红点)
- 按 Ctrl+F5 或点击侧边栏“运行和调试”图标 → 选择 Java 环境 → 点击绿色三角形启动调试
- 调试时可查看变量值、调用栈、逐步执行(F10 单步跳过,F11 单步进入)
- 想直接运行不调试?右键编辑器 → Run Java,或按 Ctrl+F5 后选 “Run Without Debugging”
首次运行时,VS Code 会自动生成 .vscode/launch.json,里面定义了启动配置(如主类名、JVM 参数)。一般无需修改,除非要传参或改 VM 选项。
基本上就这些。没用过 IDE 的新手也能照着走通。重点是 JDK 路径别错、项目结构别乱、扩展别漏装——其他都是顺带出来的。










