VSCode运行Java需安装Extension Pack for Java并手动配置java.home指向完整JDK根目录（含bin、lib），而非JRE或bin子目录；必须重启VSCode，否则语言服务器不启动、功能静默失效。
VSCode 能直接写 Java，但必须装对扩展、配对 JDK 路径，否则连 main 方法都标红、System.out.println 不补全、调试按钮灰掉——不是 VSCode 不行，是 java.home 没认准，或者扩展版本和 JDK 版本不兼容。
Java Extension Pack 安装后为啥还报“JDK not found”
常见现象：装完 Java Extension Pack，新建 .java 文件，语法高亮失效，Ctrl+Click 进不去 String 类，状态栏显示 “Java Language Server is starting…” 一直转圈。
- 根本原因通常是
java.home指向了 JRE（比如C:Program FilesJavajre1.8.0_301），而不是 JDK（必须含bin/javac和lib/tools.jar） - Windows 用户尤其容易踩坑：Oracle JDK 安装器默认勾选“安装公共 JRE”，结果系统 PATH 里加的是 JRE，VSCode 自动探测就抓错了
- macOS/Linux 用户如果用
brew install openjdk@17，路径是/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home，不是/opt/homebrew/opt/openjdk@17 - 验证方式：终端执行
ls $JAVA_HOME/bin/javac（macOS/Linux）或dir %JAVA_HOME%injavac.exe（Windows），有输出才说明路径有效
settings.json 里该配 java.home 还是 java.jdt.ls.java.home
两个配置项作用不同，混用会冲突：
-
java.home：告诉 VSCode 整体用哪个 JDK 启动语言服务器、编译器、调试器。这是最常用、最优先的配置项 -
java.jdt.ls.java.home：只影响 JDT Language Server 的 JVM 进程本身（即那个后台运行的java -jar jdtls.jar进程），一般不用动；除非你明确要让语言服务器跑在 JDK 11 上，而项目代码用 JDK 17 编译 - 如果你同时写了两个，且指向不同 JDK，VSCode 会优先读
java.home，但语言服务器启动失败时日志里可能报jdt.ls相关错误，让人误判 - 推荐只配
java.home，值为 JDK 根目录（例如"java.home": "/Library/Java/JavaVirtualMachines/jdk-17.0.9.jdk/Contents/Home"）
Maven 项目导入失败，依赖不下载、pom.xml 报红
现象：打开含 pom.xml 的文件夹，右下角弹出 “Importing Maven project…”，但几秒后消失，src/main/java 不识别为源码根目录，mvn compile 在终端能跑，VSCode 里却没自动构建。
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
- 先确认是否装了
Maven for Java扩展（它不在Java Extension Pack默认列表里，需单独搜索安装） - 检查
settings.json中是否有"maven.executable.path"配置；如果没有，VSCode 会尝试从PATH找mvn，但某些 IDE 自带的 Maven（如 IntelliJ 内置）不暴露到全局 PATH - 更稳妥的方式是显式指定：
"maven.executable.path": "/opt/apache-maven-3.9.6/bin/mvn"（macOS/Linux）或"maven.executable.path": "C:\apache-maven-3.9.6\bin\mvn.cmd"（Windows） - 如果项目用了私有仓库，还需配
java.configuration.maven.userSettings指向你的settings.xml
调试时提示 “No Java runtime present, requesting install” 或卡在 “Starting debug session…”
这不是缺 JDK，而是 VSCode 的调试器找不到可执行的 java 命令，或者权限/路径里有空格没转义。
- 确保
java.home指向的 JDK 目录下，bin/java（macOS/Linux）或binjava.exe（Windows）真实存在且可执行 - Windows 用户若 JDK 装在
C:Program Files...，路径含空格，settings.json里不用额外加引号，JSON 字符串本身已支持空格，但千万别手误写成C:Program FilesJava...（反斜杠被当转义符），应写双反斜杠C:\Program Files\Java\...或正斜杠C:/Program Files/Java/... - macOS 用户若用 Zulu JDK，注意新版 Zulu 把
java放在Contents/Home/bin，不是Contents/Home/jre/bin；旧版路径错会导致调试器启动失败 - 重启 VSCode 后，按
Ctrl+Shift+P输入Java: Configure Java Runtime，看列表里是否出现你配的 JDK 名称并打钩
真正卡住的地方往往不是步骤多，而是 JDK 路径里一个斜杠写反、一个空格没处理、或者扩展版本和 JDK 小版本不匹配——这些细节不报明确错误，只表现为功能静默失效。
