VSCode在M1/M2 Mac上运行Java必须同时满足三条件：启用Extension Pack for Java整包、java.home指向ARM64 JDK的/Contents/Home路径、手动重载Maven项目；缺一则补全失效、依赖标红或调试失败。
VSCode 在 M1/M2 Mac 上跑 Java 不是装完 JDK 就能用的，必须同时满足三个硬条件：Extension Pack for Java 全组件启用、java.home 路径指向 ARM64 JDK 的 /Contents/Home、pom.xml 手动 reload —— 缺一不可，否则补全失效、依赖标红、调试器起不来。
Extension Pack for Java 必须整包启用，不能只装 Debugger
VSCode 本身不解析 Java 语法，全靠插件。微软打包的 Extension Pack for Java 是最小可用单元，包含 Language Support for Java™ by Red Hat（负责补全/错误检查）、Debugger for Java（调试）、Test Runner for Java 等。只装其中某一个，比如只装 Debugger，会出现「能断点但没 import 提示」「代码高亮正常但 Ctrl+Space 没反应」这类割裂现象。
操作要点：
- Cmd+Shift+X 搜索
Extension Pack for Java，认准发布者是 Microsoft - 安装后必须重启 VSCode —— 否则语言服务器不启动，状态栏看不到 JDK 版本
- 如果仍提示 “No Java runtime configured”，右键插件 → “启用”，确认
Language Support for Java™处于启用状态
Java: Configure Java Runtime 是唯一可靠路径配置方式
M1/M2 Mac 上 /usr/libexec/java_home -V 输出里带 arm64 标记的那条才是原生 JDK；which java 返回的很可能是 Rosetta 转译路径，VSCode Java 扩展会直接拒绝识别。
立即学习“Java免费学习笔记（深入）”；
别碰 settings.json 里的 java.home：VSCode 1.85+ 已弃用该字段，硬写死路径（如 /Library/Java/JavaVirtualMachines/zulu-19.jdk/Contents/Home）会导致升级 JDK 后立即失效。
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
正确做法：
- 终端运行
/usr/libexec/java_home -V，复制 arm64 行末尾的完整路径（确保结尾是/Contents/Home，不含/jre） - Cmd+Shift+P → 输入
Java: Configure Java Runtime→ “JDKs” 标签页 → “+ Add JDK” → 粘贴路径 - 选中刚添加的 JDK，点击 “Set as Default”
Maven 项目必须手动 reload，否则类路径为空
VSCode 不监听 pom.xml 变更，新建或拖入 Maven 项目后，即使 mvn compile 在终端能过，VSCode 里 import java.util.List 依然会标红 —— 因为扩展还没加载依赖树和 target/classes 输出路径。
关键前提：
- 终端执行
mvn -v能返回版本号，且输出含arm64或明确标注 “Native Apple Silicon”（Rosetta 版 Maven 会卡在依赖下载或静默失败） -
~/.m2/settings.xml若配置了阿里云镜像或私有仓库，需 Cmd+Shift+P →Maven: Change Settings主动指定该文件路径
操作步骤：
- 右键项目根目录下的
pom.xml→ “Maven: Reload project”（不是 “Update project”，那是 Eclipse 术语） - 观察底部状态栏：出现 Java Projects 图标，悬停显示模块名，才表示依赖已索引完成
最容易被忽略的是架构一致性：JDK、Maven、VSCode 三者必须全是 ARM64 原生版。哪怕只有一项走 Rosetta，就会触发“编译成功但补全失效”“调试器连不上 JVM”这类隐性故障，排查时极难定位。
