VSCode运行Gradle项目需先让Java Language Server加载构建上下文，否则任务不显示、依赖标红、gradle run报错；须手动触发Link Gradle Project或Java: Import Projects，检查build.gradle语法、settings.gradle的include声明及阿里云镜像配置。
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 - 若仍无反应，在终端运行
./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
依赖下载慢、import 标红但 gradle build 成功
这是 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更可靠 - 避免手动设置
GRADLE_HOME环境变量：VSCode Gradle 插件会自己下载匹配版本，设了反而容易触发Could not determine java version from 'xx'
中文乱码、路径含空格、JDK 版本不一致
这些看似边缘的问题，往往卡住整个构建链路。尤其 Windows 下，路径和编码问题几乎必现。
-
gradlew.bat在 Windows 上执行中文输出乱码？在项目根目录建gradle.properties，加一行：org.gradle.jvmargs=-Dfile.encoding=UTF-8 -
gradle.executable.path配置路径含空格（如C:\Program Files\...）会导致静默失败；删掉该配置，让插件自动找gradlew更稳 - 终端里
gradle build成功但编辑器满屏红线？三处 JDK 必须统一：java -version（系统）、org.gradle.java.home（gradle.properties）、VSCode 设置里的java.home（指向同一 JDK 17+ 根目录） - 用
build.gradle.kts？必须装Kotlin Language Support扩展，否则任务列表永远为空
最常被忽略的一点：VSCode 的 Gradle 支持不依赖独立插件，而是靠 Extension Pack for Java 内置能力。单独再装 Gradle for Java（VMware 版）反而可能冲突。判断依据很简单——打开命令面板搜 Gradle:，有 Refresh Projects 就说明功能已就位；没有，就回去重装扩展包并重启。
