VSCode需安装JDK和Java Extension Pack才能运行调试Java；必须打开项目文件夹而非单个.java文件；优先使用CodeLens链接运行/调试，避免右键菜单；JDK路径须在设置中显式配置或通过终端启动VSCode。
VSCode 本身不原生支持 Java 运行与调试，必须依赖扩展和外部工具链。核心前提是：你已安装 JDK（java -version 和 javac -version 均能正常输出），否则所有后续步骤都会失败。
安装必要扩展：Java Extension Pack 是唯一推荐起点
仅装 Extension Pack for Java（由 Microsoft 官方维护）即可覆盖绝大多数需求，它自动包含：Language Support for Java、Debugger for Java、Test Runner for Java、Project Manager for Java、Visual Studio IntelliCode。不要单独安装其中某个子扩展——版本不匹配会导致 Unable to launch the Java debugger 或 No Java runtime present 等错误。
安装后重启 VSCode，打开一个含 .java 文件的文件夹（非单个文件），编辑器底部状态栏应出现 Java 图标并显示 JDK 版本号。若无反应，说明扩展未识别到项目结构或 JDK 路径未被正确读取。
确保工作区是标准 Maven/Gradle 项目，或至少有正确目录结构
VSCode 的 Java 扩展对“裸 .java 文件”支持极弱。直接右键单个 HelloWorld.java 点 Run Java 很可能报错：Cannot resolve classpath 或 No main class found。
立即学习“Java免费学习笔记（深入）”；
推荐做法是使用标准构建工具初始化项目：
- 终端执行
mvn archetype:generate -DgroupId=com.example -DartifactId=myapp -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false，然后用 VSCode 打开myapp文件夹 - 或使用 VSCode 内置命令：
Ctrl+Shift+P→ 输入Java: Create Java Project→ 选择Maven→ 按向导完成 - 若坚持用裸文件，请手动创建
src目录，并将.java放入其中；同时在 VSCode 设置中添加："java.project.sourcePaths": ["src"]
运行与调试操作必须通过“代码上方的 CodeLens 链接”，而非右键菜单
扩展会在每个含 public static void main(String[] args) 的类顶部注入三个链接：Run、Debug、Test（如果配了测试框架）。这是最稳定的方式。
常见误区：
- 右键
HelloWorld.java→Run Java：仅在极简单文件场景下偶然成功，多数时候因 classpath 解析失败而静默退出 - 点击侧边栏
Run and Debug视图里的绿色三角形：会提示No configuration，因为未生成.vscode/launch.json - 手动写
launch.json：除非你明确需要自定义vmArgs或env，否则完全没必要。CodeLens 已自动处理 classpath、mainClass、workingDirectory
首次点击 Debug 时，VSCode 会自动生成 .vscode/launch.json，内容类似：
{
"version": "0.2.0",
"configurations": [
{
"type": "java",
"name": "Debug (Launch)",
"request": "launch",
"mainClass": "com.example.App",
"projectName": "myapp"
}
]
}
JDK 路径配置失败是最常被忽略的硬伤
即使系统 PATH 中有 JDK，VSCode 也可能读不到。尤其在 macOS/Linux 使用 SDKMAN 或 zsh 配置 JDK 时，GUI 启动的 VSCode 不继承 shell 环境变量。
解决方法只有两个有效路径：
- 在 VSCode 设置中搜索
java.home，设置为绝对路径，例如：/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
（macOS）或C:\Program Files\Java\jdk-17
（Windows） - 从终端启动 VSCode：
code .（确保当前 shell 已正确export JAVA_HOME）
验证是否生效：打开命令面板（Ctrl+Shift+P），输入 Java: Configure Java Runtime，查看 Java Runtime 标签页里列出的 JDK 是否带勾选标记。没勾选＝没生效。
