VSCode需手动配置JDK≥17并安装Java Extension Pack才能支持Java开发；须正确设置JAVA_HOME、验证java/javac版本一致、确保路径无空格/中文，安装后重启VSCode并在状态栏确认JDK版本显示。
VSCode 本身不内置 Java 支持，必须手动配置 JDK 和安装官方 Java Extension Pack，否则连基础的语法高亮、代码补全、调试都无法工作。
确认已安装并正确配置 JDK
VSCode 的 Java 功能完全依赖系统级 JDK（不是 JRE），且要求版本 ≥ 17（推荐 17 或 21，LTS 版本最稳）。常见错误是只装了 JRE，或装了 JDK 但没配 JAVA_HOME 环境变量。
- 在终端运行
java -version和javac -version，输出必须一致且显示完整版本号（如17.0.1） - 运行
echo $JAVA_HOME（macOS/Linux）或echo %JAVA_HOME%（Windows），必须返回 JDK 安装路径（如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home） - 若未设置
JAVA_HOME，需手动添加：macOS/Linux 写入~/.zshrc，Windows 在「系统属性 → 高级 → 环境变量」中新增系统变量
安装 Java Extension Pack 并验证激活状态
这个扩展包是微软官方维护的集合，包含 Language Support for Java、Debugger for Java、Test Runner for Java 等核心组件。只装其中某一个会导致功能残缺。
- 在 VSCode 扩展市场搜索
Java Extension Pack，认准发布者为Microsoft - 安装后重启 VSCode（非重载窗口），打开任意
.java文件，状态栏右下角应显示当前 JDK 版本（如17） - 若显示
No Java runtime found，说明 VSCode 没读到JAVA_HOME，或 JDK 路径含空格/中文（Windows 常见），需修改路径或在 VSCode 设置中手动指定
必要时手动指定 JDK 路径（vscode-java.settings.json）
当系统有多个 JDK 或 JAVA_HOME 未生效时，VSCode 可能选错版本。此时需在工作区或用户设置中显式指定。
{
"java.configuration.runtimes": [
{
"name": "JavaSE-17",
"path": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"
}
]
}
- 该配置写入
.vscode/settings.json（项目级）或 VSCode 全局设置（settings.json） -
path必须指向 JDK 根目录（含bin、lib子目录），不能是 JRE 或仅jre子目录 - Windows 用户注意路径分隔符用正斜杠
/或双反斜杠\\，单反斜杠会报错
新建 Java 项目时避免 classpath 错误
VSCode 不自动生成 Maven 或 Gradle 项目结构。直接新建 .java 文件并运行，大概率报 class not found 或 source folder not recognized。
- 推荐用命令行初始化标准结构：
mkdir myapp && cd myapp && code .，再创建src/Main.java - 确保文件路径与类声明匹配：若类是
public class Main，文件必须叫Main.java，且放在src/下（非src/main/java也能跑，但后续加构建工具会冲突） - 首次编译可能卡住几秒——这是 Language Server（Java extension 后台进程）在索引 JDK 类库，等待其右下角图标停止旋转再操作
最常被忽略的是：JDK 安装路径里有空格（如 C:\Program Files\...）或中文，会导致 Java 扩展启动失败且无明确报错；还有人把 jdk-xx.jdk 直接拖进 VSCode 当文件夹打开，结果 VSCode 把整个 JDK 当作项目，触发无限扫描。这些细节比“怎么点安装”关键得多。
