VSCode能运行Java但需JDK、环境变量、插件路径三者同时成立；终端java正常不代表VSCode能读取相同环境，须显式配置java.home指向JDK根目录并重启进程。
VSCode 能跑 Java，但不是装完插件就自动好用——它依赖系统级 JDK 正确安装、环境变量生效、插件识别路径这三者同时成立。缺一环，java -version 通了，javac -version 通了，VSCode 里照样报“Cannot resolve JDK”或“no main class found”。
Java -version 和 javac -version 都正常，但 VSCode 不认 JDK
这是最常见也最容易误判的问题：终端能运行，不代表 VSCode 进程能读到同一套环境变量。
- Windows 下，如果用「系统属性→环境变量」配置了
JAVA_HOME和Path，但 VSCode 是从桌面快捷方式启动的（而非命令行中执行code），它可能继承的是旧会话或受限的环境变量快照；重启 VSCode 不够，得**彻底关闭所有 VSCode 进程（包括后台服务）再重新打开** - macOS / Linux 下，VSCode 图形界面启动时通常不加载
~/.zshrc或~/.bash_profile，导致JAVA_HOME为空；解决办法是：在终端中执行code .启动 VSCode，或在settings.json中显式设置"java.home" - 即使设置了
"java.home"，路径必须指向 JDK 根目录（如C:Program FilesEclipse Adoptiumjdk-17.0.9+9），不能是bin子目录，也不能漏掉空格转义（Windows 路径中的空格无需引号，但反斜杠要双写：C:\Program Files\...）
Extension Pack for Java 安装后仍无代码补全或调试按钮
插件包本身不带 JDK，只提供语言服务器（JDT LS）——它需要一个可用的 JDK 来启动自己的后台进程。
- 确认已安装的是完整 JDK，不是 JRE；JDK 11+ 不再自带 JRE，
jlink手动生成的jre目录对 JDT LS 无效，必须用原生 JDK 路径 - 检查 VSCode 底部状态栏：如果有黄色感叹号提示 “Java Language Server failed to start”，点开看错误日志，大概率是
java.home指向错误，或该路径下缺少lib/jdt-core.jar等关键文件 - 插件启用后首次打开
.java文件会触发 JDT LS 初始化，此时 CPU 占用高、卡顿几秒属正常；若持续超过 1 分钟无响应，可尝试在设置中增加 JVM 参数："java.jdt.ls.vmargs": "-Xmx1G -XX:+UseG1GC"
运行 Java 类时提示 “Cannot find or load main class”
这不是类路径问题，而是 VSCode 默认按“当前打开的文件所在目录”为工作目录执行 java 命令，且不自动编译。
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
- 确保你右键点击的是
.java文件（不是文件夹或空白处），且该文件含public static void main(String[] args)方法；类名必须与文件名严格一致（大小写敏感） - VSCode 的 Run Code 插件（如 Code Runner）默认用
java直接运行，不调用javac编译；务必先手动执行javac HelloWorld.java，或改用官方插件的调试模式（F5）——它会自动编译并加载bin目录下的 class 文件 - 项目结构非扁平（如含
src/main/java）时，必须用 Maven/Gradle 插件导入项目，不能靠简单打开文件夹；否则插件无法识别源码根路径和输出目录
多 JDK 版本共存时如何切换项目级 JDK
全局 "java.home" 只控制语言服务器，不影响具体项目的编译/运行目标版本；真正起作用的是 java.configuration.runtimes。
- 在
settings.json中配置多个 JDK，并标记默认项：{ "java.configuration.runtimes": [ { "name": "JavaSE-11", "path": "/Library/Java/JavaVirtualMachines/jdk-11.0.22.jdk/Contents/Home" }, { "name": "JavaSE-17", "path": "/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home", "default": true } ] } - 每个 Java 项目可在其根目录下建
.vscode/settings.json，覆盖全局设置；这样 Spring Boot 2.x 项目用 JDK 11，Spring Boot 3.x 项目用 JDK 17，互不干扰 - 注意：Maven 项目还受
pom.xml中<maven.compiler.source>和<maven.compiler.target>控制，VSCode 只负责提供对应版本的编译器支持，不强制覆盖构建行为
最常被忽略的一点：JDK 路径里有中文、空格、特殊符号，或用了符号链接（macOS 的 /usr/libexec/java_home 输出路径），都可能导致 JDT LS 启动失败且错误提示极不明确。宁可多花 30 秒复制粘贴绝对路径，也不要图省事用动态命令结果。
