必须安装并启用Language Support for Java、Debugger for Java及Extension Pack for Java三个扩展，且确保JAVA_HOME与java -version版本一致、VS Code通过终端启动以继承环境变量，项目需符合Maven/Gradle结构或配置.vscode/settings.json指定JDK路径。
装对扩展，别只装个“Java Extension Pack”就以为万事大吉
VS Code 本身不带 Java 编译和调试能力，必须靠扩展补全。但很多人装了 Java Extension Pack 就停手，结果跑不起来——它只是个合集，真正起作用的是里面几个核心扩展，缺一不可。
你得确认以下三个已启用：
-
Extension Pack for Java（合集，可装） -
Language Support for Java(TM)（提供语法、跳转、补全） -
Debugger for Java（断点、变量查看、Step Over 等必需）
漏掉 Debugger for Java，按 F5 会直接报错：Could not find the debug adapter executable；漏掉语言支持，Ctrl+Click 进不去源码，import 报红还找不到修复建议。
JAVA_HOME 和 PATH 必须对得上，且 VS Code 要能“看见”它们
VS Code 启动时读取的是**启动它的终端环境变量**，不是你 ~/.zshrc 或 ~/.bash_profile 里配好的那个。Mac/Linux 下从 Dock 或 Spotlight 启动 VS Code，它根本不知道你 shell 里设的 JAVA_HOME；Windows 下如果用快捷方式双击，也可能走系统默认路径而非你配置的 JDK。
立即学习“Java免费学习笔记（深入）”；
稳妥做法是：
- Mac/Linux：用终端执行
code .启动 VS Code（确保当前 shell 已 source 过环境变量） - Windows：用 PowerShell 或 CMD 先运行
set JAVA_HOME=C:\path\to\jdk-17，再运行code . - 检查是否生效：在 VS Code 终端里运行
echo $JAVA_HOME（Mac/Linux）或echo %JAVA_HOME%（Win），再跑java -version
常见坑：java -version 显示 11，但 JAVA_HOME 指向 jdk-17——版本不一致会导致 UnsupportedClassVersionError，尤其用新语法写完编译失败时，先看这个。
项目结构别乱放，.vscode/settings.json 得管住编译器版本
VS Code 的 Java 支持默认按 Maven 或 Gradle 结构识别项目。如果你只是新建了个 Hello.java 文件扔在桌面，它不会自动当成 Java 项目，Ctrl+Shift+P → Java: Configure Classpath 也点不动。
最小可行结构是：
- 根目录下有
src/文件夹 -
src/里有带包声明的文件，比如src/com/example/Hello.java，内容含package com.example; - 或者用
mvn archetype:generate初始化一个标准 Maven 项目
另外，不同 JDK 版本的字节码兼容性容易被忽略。在项目根目录建 .vscode/settings.json，显式指定：
{
"java.configuration.updateBuildConfiguration": "interactive",
"java.compile.nullAnalysis.mode": "automatic",
"java.configuration.runtimes": [
{
"name": "JavaSE-17",
"path": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"
}
]
}
否则编辑器可能用 JDK 11 编译，却让你写 var 或 record——语法高亮正常，一运行就 javac 报错。
运行单文件别硬套 Maven 流程，用 Code Runner 或终端更直接
不是所有 Java 代码都要搞成 Maven 项目。临时写个算法题、测个 API，用 Code Runner 扩展最省事——它会自动调 javac + java，还能传命令行参数。
但要注意两点：
- 关掉
Code Runner的runInTerminal默认值（设为false），否则中文输出乱码；真要交互输入，再手动开 - 如果类用了
package，Code Runner默认不处理包路径，会报ClassNotFoundException；此时改用集成终端：cd src && javac com/example/Hello.java && java com.example.Hello
另一个容易卡住的点：VS Code 内置终端默认编码。Windows 上 cmd 是 GBK，但 Java 源文件存 UTF-8，编译时报 非法字符。解决方法是终端里先执行 chcp 65001，或者换用 PowerShell。
复杂点永远在环境链路上：JDK 版本、环境变量加载时机、项目结构识别逻辑、终端编码——每个环节断一环，都会让“写完点一下就跑”变成查半小时日志。
