能跑通“Hello World”即成功：推荐新手直接使用微软官方一键安装包（Windows/macOS），自动集成VS Code、JDK 17（Temurin LTS）和Java Extension Pack，无需手动装JDK、配环境变量或改settings.json；安装后按Ctrl+Shift+P执行Java: Create Java Project即可生成并运行项目。
能跑通“Hello World”就是成功，不需要装一堆插件、不用改环境变量、不碰settings.json也能做到。
直接用官方一键安装包（Windows/macOS用户首选）
VS Code 官方为 Java 初学者提供了预打包的安装程序，它自动包含：VS Code本体、JDK（Temurin LTS 版）、以及Java Extension Pack。你不需要单独下载 JDK 或手动配置路径。
- Windows 用户访问：
https://aka.ms/vscode-java-installer-win - macOS 用户访问：
https://aka.ms/vscode-java-installer-mac - 安装完成后直接打开 VS Code，按
Ctrl+Shift+P输入Java: Create Java Project，选Java SE，一路回车即可生成可运行项目 - 注意：该安装包默认使用 JDK 17，不兼容旧版 Java 8 项目；如需 Java 8，必须手动切换，见下一条
手动指定 java.home（JDK 已装但 VS Code 找不到）
常见现象是点击运行时提示 The java.home variable is not set 或 Cannot resolve JDK。这不是环境变量没配好，而是 VS Code 没扫描到已安装的 JDK 路径。
- 按
Ctrl+,打开设置 → 搜索java.home→ 点击“在 settings.json 中编辑” - 添加一行（路径按你本地实际修改，注意 Windows 用双反斜杠或正斜杠）：
"java.home": "C:/Program Files/Java/jdk-17.0.8" - 保存后重启 VS Code —— 不需要加
%JAVA_HOME%或修改系统Path，VS Code 只读这个配置项 - 验证方式：按
Ctrl+Shift+P输入Java: Configure Java Runtime，看列表里是否出现你填的版本
运行单个 .java 文件失败的典型原因
初学者常建一个 HelloWorld.java 文件就点 ▶ 运行，结果报错 Error: Could not find or load main class。这和 JDK 配置无关，纯属项目结构问题。
立即学习“Java免费学习笔记（深入）”；
- VS Code 的 Java 插件默认只识别标准 Maven/Gradle 项目结构，或通过
Java: Create Java Project创建的项目 - 直接新建的
.java文件，必须放在符合规范的目录下：
– 文件名必须与 public class 名完全一致（HelloWorld.java里只能有public class HelloWorld）
– 文件不能放在桌面或根目录，建议新建文件夹（如hello），再用 VS Code **打开整个文件夹**，而非仅打开文件 - 更简单的方法：右键资源管理器 → “New File”，命名为
HelloWorld.java，粘贴代码后，右键文件 → “Run Java”（不是顶部菜单的 Run）
别被“插件全家桶”带偏节奏
看到教程列一堆插件名字就慌？其实对刚写 main 方法的新手，真正需要的只有：Language Support for Java™ by Red Hat（提供语法检查和补全）和 Debugger for Java（点小虫子图标调试）。其他像 Maven for Java、Spring Boot Extension Pack，等你遇到 pom.xml 或启动类报红时再装不迟。
最容易被忽略的一点：插件安装后，**必须重启 VS Code**，否则语言服务不会激活 —— 很多人卡在这一步，以为配置失败，其实是插件没生效。
