Extension Pack for Java必须完整安装且重启VSCode，否则语言服务器不启动；M1/M2 Mac需用/usr/libexec/java_home -v 17 -arch arm64获取ARM64 JDK的Contents/Home路径配置java.home，并通过Java: Configure Java Runtime设置java.configuration.runtimes以匹配项目Java版本。
Extension Pack for Java 必须装全，不能只装 Debugger 或 Language Support
VSCode 本身不带 Java 解析能力，Extension Pack for Java 是微软打包的一组协同工作的插件，缺任何一个都会导致功能断裂。比如只装 Debugger for Java，你可能能按 F5 启动调试，但 Ctrl+Space 补全失效、.java 文件里全是红波浪线、import 提示“unresolved”——因为语言服务器根本没起来。
安装后必须重启 VSCode（不是重载窗口），否则 Language Support for Java™ by Red Hat 不会初始化，状态栏看不到 JDK 版本，Java: Configure Java Runtime 命令也无效。
- 打开扩展面板（
Cmd+Shift+X），搜Extension Pack for Java，认准发布者是 Microsoft - 装完立刻关掉所有 VSCode 窗口，再重新打开
- 检查右下角状态栏是否显示类似
Java 17或Java 21的版本号；没有就说明语言服务器没启动
java.home 必须指向 ARM64 JDK 的 Contents/Home，不是 /usr/bin/java
M1/M2 Mac 上，which java 返回的路径大概率是 Rosetta 兼容层下的软链，而 VSCode Java 插件要求的是原生 JDK 的根目录，即包含 bin/javac 和 lib/rt.jar（或 lib/modules）的真实路径。配错会导致“No Java runtime configured”、“The project uses Java 17, but no compatible JDK is configured”等错误，且点“Configure”按钮也无效。
最可靠的方式是用系统命令查：
立即学习“Java免费学习笔记（深入）”；
/usr/libexec/java_home -v 17 -arch arm64
输出类似 /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home，把这个完整路径填进 java.home。
- 不要填
/usr/bin、/Library/Java/JavaVirtualMachines/xxx.jdk（少一层/Contents/Home） - 不要依赖
$JAVA_HOME环境变量 —— VS Code Java 插件默认不读它 - 在 VSCode 设置里搜
java.home，点“在 settings.json 中编辑”，手动写入，格式如："java.home": "/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home"
多 JDK 共存时，java.configuration.runtimes 比 java.home 更关键
java.home 只控制语言服务器（补全、诊断、重构）用哪个 JDK 启动；真正编译和运行项目，靠的是 java.configuration.runtimes。如果你的 pom.xml 写着 <java.version>21</java.version>，但 java.configuration.runtimes 里没加 JDK 21，就会出现“语法标红”（比如用 record 或 sealed）、mvn compile 报错 “source release 21 requires target release 21”。
配置方式：打开命令面板（Cmd+Shift+P），输入 Java: Configure Java Runtime → 点 “Add JDK” → 选中你本地的 JDK 21 目录（同样要到 /Contents/Home 层）→ 它会自动写进 settings.json，形如：
"java.configuration.runtimes": [
{
"name": "JavaSE-17",
"path": "/path/to/jdk-17"
},
{
"name": "JavaSE-21",
"path": "/path/to/jdk-21"
}
]
-
name字段必须严格匹配 Eclipse JDT 规范（如JavaSE-17、JavaSE-21），不能写成jdk-17或17 - 每个
path都要指向/Contents/Home，不是.jdk根目录 - 如果项目用 Gradle，还要额外配
java.configuration.gradle.javaHome
Maven 项目导入失败？先检查 maven.executable.path 和 settings.xml
装完插件、配好 JDK，打开含 pom.xml 的文件夹，右键点 pom.xml → “Import to Workspace”，如果卡在 “Resolving dependencies…” 或报 “Could not resolve dependencies”，大概率不是网络问题，而是 Maven 自身没配好。
VS Code 的 Maven for Java 插件默认调用 mvn 命令，但它不走系统 PATH，也不读全局 ~/.m2/settings.xml，必须显式指定：
- 在设置里搜
maven.executable.path，填入你本地mvn的绝对路径（如/opt/homebrew/bin/mvn） - 搜
maven.settings.file，设为你的settings.xml路径（如~/.m2/settings.xml），确保里面已配阿里云镜像 - 确认 Maven 版本与 JDK 架构一致：ARM64 JDK 必须配 ARM64 Maven，混用 Rosetta Maven 会静默失败
导入成功后，侧边栏会出现 “Maven Projects” 面板，依赖树能展开，mvn clean compile 在集成终端里也能跑通，才算真正就绪。
