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 项目向导，但可通过命令行 + 扩展快速生成标准结构。
立即学习“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 路径、扩展是否启用、源码目录标记。配好一次，后续新建项目基本复用同一套环境。
