vscode能运行调试gradle java项目，但需java language server加载上下文、gradle插件同步任务、三处jdk版本对齐，否则出现任务为空、依赖标红、找不到主类、断点失效等问题。
VSCode 能运行和调试 Gradle 构建的 Java 项目，但前提是它真正“认出”了这个项目——不是打开文件夹就自动生效，而是要让 Java Language Server 加载构建上下文、Gradle 插件同步任务、JDK 版本三处对齐。否则你会看到任务列表为空、依赖标红、gradle run 报 Could not find or load main class、断点不命中等现象。
Gradle 任务不显示？先触发项目同步
VSCode 不会自动扫描 build.gradle 并注册任务。即使插件已装、文件存在，任务面板仍可能显示 “No tasks found”。
- 右键点击项目根目录下的
build.gradle文件 → 选择Link Gradle Project - 或按
Ctrl+Shift+P（Windows/Linux）/Cmd+Shift+P（macOS），输入并执行Java: Import Projects - 多模块项目必须检查
settings.gradle是否包含include 'module-name'，漏写会导致子模块完全不被加载 - 若仍无反应，在终端运行
./gradlew tasks：报错说明 wrapper 本身有问题（如gradle/wrapper/gradle-wrapper.properties中的distributionUrl被墙，或 JDK 版本低于 Gradle 要求）
gradle run 在终端能跑，VSCode 里却找不到主类
VSCode 的 gradle run 任务默认不读取 application 插件配置，也不继承 gradle.properties 或系统属性，它用的是插件自建的最小 JVM 上下文。
- 确保
build.gradle中启用了application插件：plugins { id 'application' } - 显式声明主类：
application { mainClass = 'com.example.Main' }（注意不是mainClassName，那是旧版写法） - 不要依赖
gradle.properties里的systemProp.配置——VSCode 任务不加载这些，改用applicationDefaultJvmArgs或直接在自定义 task 中覆写 - 如果项目含多个可运行类，VSCode 默认只识别
application.mainClass指定的那个；想临时换主类，得手动编辑.vscode/tasks.json，加一个带args的自定义 task
调试时断点不命中或报错 No Java runtime present
调试入口来自代码中的 public static void main(String[] args)，但 VSCode 的调试器不会自动复用 Gradle 的 classpath 或 JVM 配置。
- 打开含
main方法的类文件，编辑器顶部会出现绿色运行按钮，点击下拉箭头选择Debug；首次运行会生成.vscode/launch.json -
launch.json中必须明确指定mainClass和projectName（后者需与build.gradle中的rootProject.name或模块名一致） - 确保三处 JDK 版本统一：
java -version（终端）、org.gradle.java.home（写在项目根目录gradle.properties中）、VSCode 设置里的java.home（通过Java: Configure Java Runtime设置） - 别设系统级
GRADLE_HOME：VSCode Gradle 插件会自行下载匹配版本，手动指定可能触发Could not determine java version from 'xx'
依赖标红但 gradle build 成功？语言服务器没同步
这是 Java Language Server 和 Gradle 插件之间 classpath 同步断裂的典型表现。编译器“知道”依赖存在，但编辑器索引没更新。
- 按
Ctrl+Shift+P输入Java: Reload Project—— 注意不是Reload Window，后者完全无效 - 检查
settings.json中是否设了"java.configuration.updateBuildConfiguration": "interactive"，改成"automatic"才能实时响应build.gradle变更 - 国内用户务必在
build.gradle的repositories块中优先写：maven { url 'https://maven.aliyun.com/repository/public' }，比改全局~/.gradle/init.gradle更直接有效 - Linux/macOS 下确认
gradlew有执行权限：chmod +x gradlew，否则 VSCode 调不起包装脚本，静默失败
最常被忽略的是：VSCode 的 Java 扩展不自动读取 build.gradle 里的 sourceCompatibility 或 targetCompatibility，它只认 java.home 对应的 JDK 能力。如果你用 JDK 17 编译，但 java.home 指向 JDK 21，编辑器就会报 java.lang.String 找不到——这种错不会出现在终端构建里，只会在编辑器里幽灵般出现。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
