VSCode需手动配置java.home、gradle.java.home和launch.json中的projectName三者严格一致，否则导致JDK识别错误、Gradle构建失败、断点不生效等问题；必须用绝对路径、匹配JDK与Gradle版本，并重启VSCode生效。
Java环境没被VSCode识别，java.home必须手动指定
VSCode不会自动扫描系统PATH里的java命令，尤其在多版本共存（如JDK 17 + JDK 21）时，它常默认用错版本或直接报“Cannot resolve JDK”。关键动作是显式配置java.home——不是改系统变量，而是VSCode用户设置里填绝对路径。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 先在终端运行
java -version和which java（macOS/Linux）或where java（Windows），确认你真正想用的JDK安装路径，比如/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home - 打开VSCode设置（
Cmd+,或Ctrl+,），搜索java.home，点击“Edit in settings.json”，填入完整路径字符串，注意Windows要用双反斜杠或正斜杠："java.home": "C:/Program Files/Java/jdk-21" - 重启VSCode——仅重载窗口不够，必须完全退出再启动，否则
Java Extension Pack可能仍缓存旧配置
Gradle项目导入后不显示src结构，gradle.java.home和gradle.distributionUrl要对齐
常见现象：项目根目录有build.gradle，但VSCode里src/main/java不折叠展开、类无法跳转、@Override标红。本质是Java插件调用Gradle时用了错误JDK或Gradle wrapper版本不兼容。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 检查项目级
.vscode/settings.json（非用户级），确保设了"gradle.java.home"，值必须和全局java.home一致；否则Gradle编译用JDK 17，而编辑器语义分析用JDK 21，类型推导就崩 - 打开
gradle/wrapper/gradle-wrapper.properties，核对distributionUrl是否匹配JDK版本：Gradle 8.0+ 要求 JDK 17+，Gradle 8.9+ 推荐 JDK 21；若用JDK 21 却配了gradle-7.6-bin.zip，会静默失败 - 删掉
.gradle和build目录，再右键build.gradle→ “Refresh Gradle project”，避免旧缓存干扰
按Ctrl+Click进不到第三方依赖源码，java.configuration.updateBuildConfiguration得设为interactive
默认情况下，VSCode Java插件只解析本项目代码，对implementation 'org.springframework:spring-web:6.1.12'这类依赖，点进去只能看到class反编译结果，没有源码和Javadoc。这不是Gradle没下载源码，而是VSCode没触发源码关联流程。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 在设置中搜
java.configuration.updateBuildConfiguration，把它从默认的never改成interactive——这样首次打开项目或修改build.gradle后，会弹窗问“是否更新构建配置”，选“是”才会拉取源码和Javadoc - 如果已错过弹窗，手动触发：按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入Java: Configure Classpath，选当前项目，再选“Download sources and Javadoc” - 注意：部分私有仓库（如Nexus）需提前在
~/.gradle/init.gradle里配好认证，否则源码下载会卡在401
调试时断点不生效，launch.json里projectName必须和settings.gradle里定义的一致
Gradle多模块项目最常踩的坑：根项目下有api/、core/子模块，你在core里打的断点，调试却跑不到——因为launch.json里"projectName"写的是"core"，但settings.gradle里实际注册的是include 'core-module'，名字对不上，VSCode根本找不到对应模块的编译输出路径。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 打开
settings.gradle，逐行看include语句，比如include ':api', ':core-module'，那launch.json里projectName就得严格写成"core-module"，不能简写为"core" -
mainClass别写全限定名带$符号的内部类（如com.example.App$Runner），只写顶层启动类，内部类断点支持不稳定 - 确认
build.gradle里application.mainClass = "com.example.App"和launch.json的mainClass完全一致，大小写都不能错
java.home、gradle.java.home、projectName——任何一处拼写偏差或层级错位，都会导致编译、索引、调试三个环节各自失效，且错误提示往往藏在不同面板里，不容易关联判断。 
