VSCode写Java项目需手动配置JDK并安装对应构建工具插件：先装JDK 17/21 LTS，设JAVA_HOME，用Java Extension Pack；Maven项目需装Maven for Java插件并配mvn路径；Gradle项目依赖wrapper，确保gradlew可用；最后验证运行和依赖解析是否正常。
vscode 本身不内置 java 运行环境，要写 java 项目，必须手动配置 jdk，并根据项目类型（maven 或 gradle）安装对应插件和设置构建工具路径。关键不是装得全，而是路径对、插件准、配置稳。
装好 JDK 并让 VSCode 找得到
VSCode 的 Java 支持依赖 Java Extension Pack（含 Language Support for Java™ by Red Hat），但它不会自动下载 JDK。你需要：
- 从 Eclipse Temurin 或 Oracle JDK 下载并安装 JDK（推荐 JDK 17 或 JDK 21，LTS 版本更稳定）
- 配置系统环境变量
JAVA_HOME指向 JDK 根目录（如C:\Program Files\Eclipse Adoptium\jdk-17.0.1+12或/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home） - 在 VSCode 中按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Java: Configure Java Runtime，在打开的页面里确认已识别的 JDK 版本；若没列出来，点击+ Add JDK手动指定JAVA_HOME路径
用 Maven 创建或打开项目
Maven 项目靠 pom.xml 驱动。VSCode 需要 Maven 插件支持解析依赖和执行生命周期命令：
- 安装扩展 Maven for Java（由 Microsoft 提供）
- 确保本地已安装 Maven（命令行运行
mvn -v可见版本），或在 VSCode 设置中指定 Maven 路径：java.configuration.maven.userSettings（可选）、java.maven.path（填 Maven 解压后的bin目录，如/opt/apache-maven-3.9.6/bin） - 打开含
pom.xml的文件夹后，侧边栏会出现 Maven Projects 视图，可一键编译（compile）、打包（package）、运行（spring-boot:run等） - 首次加载时右下角可能弹出 “Import Maven project?”，点 Yes 让插件自动下载依赖并配置 classpath
用 Gradle 创建或打开项目
Gradle 项目靠 build.gradle（或 build.gradle.kts）定义逻辑。VSCode 对 Gradle 的支持主要来自 Java 扩展包自带的 Gradle 功能，但需注意：
- 无需额外安装 Gradle 插件，但必须保证项目根目录下有
gradlew（Linux/macOS）或gradlew.bat（Windows） - VSCode 默认使用 Wrapper 自动下载匹配版本的 Gradle，所以只要
gradle/wrapper/gradle-wrapper.properties里的distributionUrl可访问，就能正常导入 - 打开项目后，点击左侧 Activity Bar 的 Java Projects 图标，在 Build Tools 区域会显示 Gradle 任务列表（如
build、test、bootRun） - 如果 Gradle 同步失败，检查是否被代理/防火墙拦截，或尝试在终端中先运行
./gradlew --version确认本地可用
验证与常见问题
配置完别急着写代码，先做两件事验证是否真正就绪：
立即学习“Java免费学习笔记（深入）”；
- 新建一个
.java文件，写个public class Hello { public static void main(String[] args) { System.out.println("OK"); } }，按Ctrl+F5运行——能输出即 JDK 和运行时通了 - 打开
pom.xml或build.gradle，看 VSCode 是否能解析依赖（类名悬停显示 Javadoc、import不报红、Ctrl+Click可跳转到依赖源码） - 常见卡点：
Unable to import maven project多因网络问题导致中央仓库拉不到依赖，可配置阿里云镜像；Gradle project sync failed常因 wrapper 版本太新或 JDK 版本不兼容，降级 Gradle 或换 JDK 再试
基本上就这些。不复杂但容易忽略环境变量和首次导入确认步骤。
