VSCode能运行Gradle项目，但需手动触发Java: Import Projects或Link Gradle Project使Language Server加载构建上下文；否则任务不显示、依赖标红、gradle run报找不到主类；多模块须检查settings.gradle的include声明，JDK版本、gradle-wrapper权限及阿里云镜像配置须对齐。
VSCode 能运行 Gradle 项目，但前提是它得“认出”这是个 Gradle 项目——不是装了插件就自动生效，而是要让 Java Language Server 加载进正确的构建上下文。否则你会遇到任务不显示、依赖标红、gradle run 报 Could not find or load main class 等典型症状。
Gradle 任务列表为空？先确认项目被真正识别
VSCode 不会自动扫描 build.gradle 并注册任务，必须手动触发同步。常见假象是文件存在、插件已装，但侧边栏没出现 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
依赖标红但 ./gradlew build 成功？Java Language Server 同步断裂
这是 VSCode 的 Java Language Server 和 Gradle 插件之间 classpath 同步断裂的典型表现。编译器“知道”依赖存在，但编辑器索引没更新。
立即学习“Java免费学习笔记（深入）”；
- 按
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更直接有效 - 如果刚加了新依赖但没生效，别等自动刷新——手动触发一次
Java: Reload Project是最稳解法
Gradle 插件要不要单独装？三处 Java 版本必须对齐
截至 2026 年，Extension Pack for Java 已内置 Gradle 支持能力，单独再装 Gradle for Java（VMware 版）反而可能引发冲突或任务重复注册。真正容易被忽略的是三处 Java 版本是否统一：
-
java -version（终端运行时） -
org.gradle.java.home（写在项目根目录gradle.properties中） - VSCode 设置里的
java.home（通过Java: Configure Java Runtime设置） - 最稳做法：在项目根目录建
gradle.properties，写死org.gradle.java.home=/path/to/jdk-17；同时在 VSCode 设置中把java.home指向同一个路径
别设系统级 GRADLE_HOME：VSCode Gradle 插件会自行下载匹配版本，手动指定可能触发 Could not determine java version from 'xx'。真正的卡点往往不在插件装没装全，而在 JDK 路径和 Gradle wrapper 权限这两处静默失败的地方。
