VSCode 运行 Java 需安装 Extension Pack for Java、配置 ARM64 JDK 路径、重载 Maven 项目，并为 Spring Boot 额外安装对应扩展包；M1/M2 Mac 必须确保 JDK 与 Maven 架构一致。
VSCode 能跑 Java，但默认不支持——必须装插件、配 JDK、设 Maven，缺一不可；M1/M2 Mac 还得特别注意 JDK 架构匹配，否则 java.home 配对失败、语言服务器起不来、补全和调试全挂。
Extension Pack for Java 必须装，且要确认 Red Hat 的 Language Support 插件已启用
VSCode 本身不带 Java 解析能力，Extension Pack for Java 是微软官方打包的一组核心插件，包含 Language Support for Java™ by Red Hat、Debugger for Java 等。只装其中某一个（比如只装 Debugger）会导致语法高亮正常但无补全、无错误提示。
- 打开 VSCode，按
Cmd+Shift+X进扩展面板，搜Extension Pack for Java，认准发布者是Microsoft - 安装后务必重启 VSCode —— 否则语言服务器（Java Language Server）不会启动，状态栏看不到 JDK 版本，
Ctrl+Space补全无效 - 如果装完仍提示 “No Java runtime configured”，说明
Language Support for Java没生效，检查是否被禁用（右键插件 → “启用”）
JDK 路径必须手动指定，/usr/libexec/java_home 是 M1/M2 最可靠来源
M1/M2 Mac 上 JDK 安装路径不固定，which java 返回的可能是 Rosetta 兼容层路径，而 VSCode Java 扩展要求原生 ARM64 JDK 的 Contents/Home 目录。硬写死路径（如 /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home）容易因版本升级失效。
- 终端运行
/usr/libexec/java_home -V查看所有已安装 JDK 列表，找带arm64标记的那条 - 复制对应路径，去掉末尾
/jre（如有），确保结尾是/Contents/Home - 在 VSCode 中按
Cmd+Shift+P，输入Java: Configure Java Runtime，点击+ Add JDK，粘贴该路径 - 别在
settings.json里硬写"java.home"—— VSCode 1.85+ 已弃用该配置项，改用运行时面板管理更稳定
Maven 项目必须 reload，否则依赖不加载、类路径为空
VSCode 不像 IDEA 那样自动监听 pom.xml 变更。新建或导入 Maven 项目后，即使 pom.xml 语法正确，src/main/java 下的类也会报 “Cannot resolve symbol” —— 因为扩展还没解析依赖树和编译输出路径。
立即学习“Java免费学习笔记（深入）”；
- 确保系统已安装 Maven：
mvn -v能返回版本号，且是 ARM64 原生版（非 Rosetta 转译） - 在 VSCode 中右键点击
pom.xml文件，选Maven: Reload project（不是 “Update project”，那是 Eclipse 术语） - 观察底部状态栏：出现
Java Projects图标且悬停显示模块数，才代表加载成功 - 如果 reload 后仍报错，检查
~/.m2/settings.xml是否配置了阿里云镜像；没配的话依赖下载极慢，reload 会超时静默失败
Spring Boot 项目需额外装 Spring Boot Extension Pack，否则 run/debug 按钮不出现
纯 Java 或普通 Maven 项目能 run，但 Spring Boot 的 @SpringBootApplication 类默认不会被识别为可启动入口 —— VSCode Java 扩展不内置 Spring Boot 元数据解析。
- 搜索并安装
Spring Boot Extension Pack（发布者：Pivotal，现属 VMware） - 安装后打开含
spring-boot-starter-web的项目，等右下角弹出 “Enable Spring Boot support?” 提示，点 “Yes” - 此时再打开主启动类，顶部会出现绿色 ▶️ 按钮，点击即可启动；断点也能命中
- 若按钮不出现，检查
application.properties是否存在，且项目根目录下有pom.xml或build.gradle—— 缺任一，扩展不触发激活逻辑
最容易被忽略的是：M1/M2 上 JDK 和 Maven 必须同为 ARM64 架构。混用 x86 JDK + ARM64 Maven，或反过来，会导致 mvn compile 成功但 VSCode 内部构建失败，错误日志藏在 Java Language Server 输出通道里，不点开根本看不到。
