VSCode识别不到JDK需检查JAVA_HOME是否指向JDK根目录，并在Java: Configure Java Runtime中手动添加路径；多JDK时需清理settings.json中硬编码的过时版本。
VSCode识别不到JDK：检查JAVA_HOME和扩展设置是否冲突
VSCode本身不自带Java运行时，必须显式告诉它用哪个JDK。常见现象是安装完JDK后，Extension Pack for Java仍提示“JDK not found”或java.home报红——这通常不是JDK没装好，而是VSCode没读到正确路径。
- 先确认
JAVA_HOME环境变量已设为JDK根目录（如C:\Program Files\Java\jdk-17.0.2或/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home），不是jre子目录，也不是bin目录 - 在VSCode中按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Java: Configure Java Runtime，在“JDKs”选项卡里手动添加JDK路径（推荐优先用此方式，比依赖JAVA_HOME更可靠） - 如果同时装了多个JDK（比如JDK 8和JDK 17），确保项目
.vscode/settings.json里没硬编码过时版本："java.configuration.runtimes": [{"name": "JavaSE-1.8", "path": "..."}]——这种写法容易导致编译器版本和运行时错配
新建Java项目后mvn compile失败：Maven配置未生效或settings.xml路径不对
Maven插件（如vscode-maven）默认只读取全局settings.xml，但多数人把私有仓库、镜像或认证信息写在用户级~/.m2/settings.xml里，VSCode却没加载它。
- 打开VSCode命令面板，运行
Maven: Change Settings，选择你实际使用的settings.xml文件（通常是~/.m2/settings.xml） - 检查
settings.xml里<localrepository></localrepository>路径是否可写；若指向C:\Program Files\...这类系统保护目录，Maven会静默失败 - 如果公司使用私有Nexus/Artifactory，确认
<server></server>块中的id与<mirror></mirror>的mirrorOf匹配，且~/.m2/settings.xml权限允许VSCode读取（macOS/Linux注意chmod 600）
IntelliSense不提示Maven依赖类：项目没被正确导入为Maven项目
单纯创建pom.xml文件，VSCode不会自动解析依赖并索引类库。必须触发一次“导入”，否则import java.util.List可能标红，但编译其实能过。
- 右键点击
pom.xml→ 选择Import to Workspace（不是“Open with”或“Run as Maven build”） - 观察状态栏右下角是否出现
Building workspace...，完成后应显示Java Projects: X projects - 若提示“Project configuration is not up-to-date with pom.xml”，点通知里的
Update project（等价于mvn eclipse:eclipse旧逻辑，但VSCode用的是自己实现的增量解析） - 依赖下载慢？在
settings.json加一行："maven.downloadSources": true，强制下载源码包，IntelliSense才完整
调试时断点不命中或No executable code found：编译输出路径与调试器不一致
VSCode Java调试器默认找target/classes下的字节码，但如果你改过pom.xml里的<outputdirectory></outputdirectory>，或用了Lombok等注解处理器，就容易脱节。
立即学习“Java免费学习笔记（深入）”；
- 确认
pom.xml中没自定义<build><outputdirectory></outputdirectory></build>；如有，需同步修改VSCode的java.compile.nullAnalysis.mode相关设置（极少需要） - Lombok项目必须安装
Lombok Annotations Support for VS Code扩展，并在settings.json启用："java.configuration.updateBuildConfiguration": "interactive"，否则生成的lombok.Generated类不被调试器识别 - 调试前务必执行一次
mvn compile（或点击编辑器上方“Compile”按钮），避免调试器读取旧class文件
toolchains.xml，Maven的settings.xml要对得上网络代理，而调试器又得认得出编译输出结构。这些链路一环断，错误提示往往不直接告诉你哪错了。 
