在 VSCode 中搭建 Java 开发环境需安装 Extension Pack for Java 和 Project Manager for Java 扩展,配置 JDK 17 或 21 的 java.home 路径,创建标准 Maven 项目或手动建立 src/main/java 结构,并生成正确的 launch.json 启动配置。

在 VSCode 中搭建 Java 开发环境,核心是装对扩展、配好 JDK 路径、理解项目结构,而不是堆砌插件。
装好基础扩展和 JDK
VSCode 本身不支持 Java,必须依赖扩展。只需安装两个关键扩展:
- Extension Pack for Java(微软官方打包,含 Language Support、Debugger、Test Runner 等)
- Project Manager for Java(方便切换和管理多个 Java 项目)
JDK 推荐用 JDK 17 或 JDK 21(LTS 版本),安装后记下路径,比如 C:\Program Files\Java\jdk-17.0.2 或 /Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home。VSCode 不会自动识别 JDK,需手动配置。
配置 JDK 路径(关键一步)
打开 VSCode 设置(Ctrl+, 或 Cmd+,),搜索 java.home,点击 Edit in settings.json,添加一行:
立即学习“Java免费学习笔记(深入)”;
"java.home": "/path/to/your/jdk"Windows 用户注意路径用正斜杠或双反斜杠,例如:"java.home": "C:/Program Files/Java/jdk-17.0.2"。配错会导致“Cannot resolve JDK”或代码无语法提示。
创建或打开一个标准 Java 项目
VSCode 对 Java 的支持依赖项目结构。推荐两种方式:
- 用 Maven 创建:终端运行
mvn archetype:generate -DgroupId=com.example -DartifactId=myapp -DarchetypeArtifactId=maven-archetype-quickstart,然后用 VSCode 打开该文件夹 - 直接新建文件夹,放入
src/main/java/目录,再新建.vscode/settings.json并写入{"java.configuration.updateBuildConfiguration": "interactive"},保存后右下角点“Allow”让插件扫描源码
没有 src 和 bin(或 target)结构,智能提示和调试大概率不工作。
运行和调试别跳过 launch.json
首次调试 Java 类时,VSCode 会提示生成 .vscode/launch.json。选 Java 环境,它会自动生成带 mainClass 的配置。确保 mainClass 值正确,比如 "mainClass": "com.example.App",对应你含 public static void main 的类全名。
如果报 “No executable found”,检查三点:类里有没有 main 方法、包名是否匹配、launch.json 里的 mainClass 是否拼错。
基本上就这些。不复杂但容易忽略路径和结构——配对 JDK、放对 src、生成对 launch.json,Java 就能跑起来。










