VSCode需安装Gradle for Java扩展才能识别build.gradle任务；未安装则“运行任务”无反应，且须配置镜像仓库、禁用GRADLE_HOME、刷新项目并避免离线模式导致依赖不同步。
Gradle插件装不全，gradle build 在终端能跑，VSCode里点“运行任务”却没反应
VSCode本身不内置Gradle支持，光装了Java Extension Pack还不够——它只管编译和调试Java代码，不管构建流程。真正驱动gradle build、gradle test这些任务的是Gradle for Java扩展（由Microsoft官方维护，图标是蓝绿色的齿轮）。没装它，VSCode根本识别不了build.gradle里的任务定义。
装完后还要确认：打开项目根目录（含build.gradle或settings.gradle），右下角状态栏应显示Gradle字样；如果显示“Loading Gradle projects…”卡住，大概率是gradlew权限问题或GRADLE_HOME冲突。
- Linux/macOS执行
chmod +x gradlew，否则VSCode调不起包装脚本 - 别在系统环境变量里设
GRADLE_HOME，VSCode的Gradle插件会自己下载对应版本，手动指定反而容易触发Could not determine java version from 'xx' - 如果项目用Kotlin DSL（
build.gradle.kts），确保已安装Kotlin Language Support扩展，否则任务列表为空
依赖下载慢、失败，或者import xxx标红但gradle build明明成功
这是典型的VSCode Java语言服务器（JDK）和Gradle解析器“看到的类路径不一致”。Java Extension默认用java.home配置的JDK去索引源码，但它并不自动读取build.gradle里声明的sourceCompatibility或dependency，得靠Gradle插件把结果同步过去。
常见现象：改完build.gradle加了implementation 'com.google.guava:guava:33.2.1-jre'，保存后VSCode不自动下载jar，也不更新导入提示。
立即学习“Java免费学习笔记（深入）”；
- 按
Ctrl+Shift+P（macOSCmd+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 run报错Could not find or load main class，但命令行里能跑
VSCode执行gradle run时，默认用的是插件自建的运行配置，它不读gradle.properties或systemProp，也不会自动识别application插件配置的mainClass。错误本质是启动参数缺失，而非类不存在。
最稳的解法不是硬调插件，而是绕过它，直接用VSCode的launch.json跑主类：
{
"version": "0.2.0",
"configurations": [
{
"type": "java",
"name": "Launch App",
"request": "launch",
"mainClass": "com.example.Main",
"projectName": "my-project"
}
]
}
-
mainClass必须写全限定名，不能写Main或src/main/java/... -
projectName填settings.gradle里rootProject.name的值，大小写敏感 - 如果项目有多个模块，确保
build.gradle里该模块应用了application插件，并设置了application.mainClass = "com.example.Main"，否则gradle run本身就不成立
修改build.gradle后，VSCode不重新下载依赖，甚至缓存旧版本
Gradle插件默认开启离线模式（offline mode）做性能优化，但它不会主动检测build.gradle内容变更，只监听文件是否被保存。而有些编辑器保存时可能只写入临时文件再替换，导致插件错过事件；更常见的是，它缓存了上一次解析的依赖树，没触发完整重载。
别指望“保存即生效”，得手动干预：
- 右键点击项目根目录下的
build.gradle→ 选Refresh Gradle project（不是“Refresh dependencies”） - 如果依赖仍不对，删掉
.gradle目录和build目录，再刷新——Gradle插件不会自动清理输出，残留class文件会导致java.lang.NoClassDefFoundError - 留意
dependencies块里用了+号（如implementation 'junit:junit:4.+'），VSCode解析时可能卡在版本选择逻辑里，建议锁定具体小版本
Gradle配置不是写完就结束的事，它和VSCode的Java语言服务之间存在两层缓存：Gradle自己的.gradle/caches，以及VSCode的java.project.sourcePaths索引。任何一方没对齐，就会出现“代码能编译，但跳转不到源码”“提示有方法，运行时报NoSuchMethodError”这类隐性问题。
