vscode能运行gradle任务但需手动触发java language server加载构建上下文，否则任务为空、依赖标红、run报错；须执行link gradle project或java: import projects，并确保build.gradle语法正确、settings.gradle含include声明、使用gradlew而非全局gradle。
VSCode 能运行 Gradle 任务，但不会自动识别或执行——必须让 Java Language Server 加载构建上下文，否则任务列表为空、点击报错、依赖标红全是常态。
Gradle 任务列表为空？先确认项目被真正识别
VSCode 不会扫描 build.gradle 就自动注册任务。常见假象是文件存在、插件已装，但侧边栏没 Gradle 图标，或“Tasks: Run Task”里只显示 No tasks found。
- 右键点击
build.gradle→ 选择Link Gradle Project - 或按
Ctrl+Shift+P（Windows/Linux）/Cmd+Shift+P（macOS），输入并执行Java: Import Projects - 仍无反应？在终端运行
./gradlew tasks：若报错，说明 wrapper 本身有问题（比如gradle/wrapper/gradle-wrapper.properties中的distributionUrl被墙，或 JDK 版本低于 Gradle 要求） - 多模块项目务必检查
settings.gradle是否漏写include 'module-name'，否则子模块根本不会被加载
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
Gradle 插件报 Command 'gradle' not found
VSCode 本身不自带 Gradle，插件只是调度器，真正执行靠系统 PATH 里的 Gradle（或 wrapper）。
- 先在终端运行
which gradle（macOS/Linux）或where gradle（Windows），确认是否已全局安装；没输出就说明没装，别硬配插件 - 更推荐用项目级
gradlew：确保根目录有gradlew（Linux/macOS）或gradlew.bat（Windows），VSCode 插件默认优先找它 - 如果手动指定了
gradle.executable.path配置，注意路径里不能带空格（比如C:\Program Files\），否则 Windows 下大概率静默失败；改用短路径如C:\Progra~1\，或直接删掉该配置，让插件自动探测
依赖标红但 gradle build 成功
这是 Java Language Server 和 Gradle 插件之间 classpath 同步断裂的典型表现：编译器“知道”依赖存在，但编辑器索引没更新。
- 按
Ctrl+Shift+P输入Java: Reload Project——注意不是Reload Window，后者完全无效 - 检查
settings.json中是否设了"java.configuration.updateBuildConfiguration": "interactive"，改成"automatic"才能实时响应build.gradle变更（截至 2026 年 5 月 3 日） - 确认三处 Java 版本统一：
java -version（JDK 运行时）、org.gradle.java.home（Gradle 配置的 JDK）、VSCode 的java.home设置（Java 扩展用）；不一致会导致编译通过但编辑器满屏红线
最容易被忽略的是：VSCode 的 Gradle 支持高度依赖 Java Language Server 的状态，而这个服务对构建文件变更、JDK 切换、甚至 shell 环境 PATH 的刷新都不敏感——很多问题表面是 Gradle 配置问题，实际是 Java 扩展没 reload 或没选对 runtime。每次怀疑配置失效，先做 Java: Reload Project，再查 Java: Configure Java Runtime，比反复重装插件管用得多。
