vscode不执行gradle构建，仅调度任务；真正执行靠gradlew或path中的gradle。主因是路径错误、jdk三处不一致（java.home/org.gradle.java.home/javaversion）或未装gradle for java插件。
VSCode 本身不执行 Gradle 构建，它只调度任务；真正干活的是 gradlew 或系统 PATH 中的 gradle。配置失败的主因，90% 是路径、JDK 不一致或插件没装对。
Gradle for Java 插件必须装，且不是“Java Extension Pack”里的子项
Java Extension Pack 只提供语法、调试和编译支持，不识别 build.gradle 里的 task。必须单独安装官方插件：Gradle for Java（图标是蓝绿色齿轮，Publisher 是 Microsoft）。装完后打开含 build.gradle 或 settings.gradle 的文件夹，右下角状态栏应显示 “Gradle” 字样。如果没反应：
- 检查是否在项目根目录（不是子模块）打开文件夹
- 确认
build.gradle文件名拼写正确，不是Build.gradle或build.Gradle - Linux/macOS 下若用
gradlew，先运行chmod +x gradlew，否则 VSCode 调不起脚本 - Windows 用户避免在
gradle.executable.path配置中写带空格路径（如C:\Program Files\），会静默失败
Java 版本三处必须统一：java.home / org.gradle.java.home / 编译目标
VSCode Java 扩展读 java.home，Gradle 运行时读 org.gradle.java.home（或 JAVA_HOME），而 build.gradle 里又可能设了 javaVersion = JavaVersion.VERSION_21。三者不一致会导致：
- 编辑器报红（如
String.isBlank()标红），但./gradlew build成功 - 运行时
NoClassDefFoundError，尤其用到新 API 时 - Gradle 同步卡在 “Loading Gradle projects…”
解决方式：
- 在 VSCode
settings.json中显式设"java.home": "/path/to/jdk-21" - 在项目级
gradle.properties中写死org.gradle.java.home=/path/to/jdk-21 - 在
build.gradle中保持javaVersion = JavaVersion.VERSION_21与前两者一致
自定义 task 不出现在任务列表？得手动写 tasks.json
VSCode 默认只列出 Gradle 生命周期 task（build、test、clean），你写了 task deployToStaging，它不会自动出现。必须在项目根目录建 .vscode/tasks.json，内容如下：
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
{
"version": "2.0.0",
"tasks": [
{
"type": "gradle",
"name": "deployToStaging",
"gradleFile": "build.gradle",
"task": "deployToStaging",
"group": "build"
}
]
}
关键点：
-
"type": "gradle"必须写对，不是"shell"或"process"，否则插件不接管依赖图 - 如果 task 有
dependsOn 'compileJava'，不用额外声明依赖，Gradle 自己解析；但若只用doLast顺序执行，VSCode 无法感知依赖关系 - 改完
tasks.json后，按Ctrl+Shift+P→ “Tasks: Run Task”，就能看到新任务
中文乱码、依赖不同步、镜像仓库这些坑都在 gradle.properties 和 build.gradle 里
控制台输出中文变问号？不是终端字体问题，是 JVM 启动参数缺编码：
- 在项目级
gradle.properties加：org.gradle.jvmargs=-Dfile.encoding=UTF-8
依赖明明加了却标红、import 不生效？这是 Java 语言服务器没同步 Gradle 解析结果：
- 按
Ctrl+Shift+P→ “Java: Reload Project”（不是 Reload Window） - 确保
settings.json里有"java.configuration.updateBuildConfiguration": "automatic" - 国内用户优先在
build.gradle的repositories块里加阿里云镜像：maven { url 'https://maven.aliyun.com/repository/public' }，比改全局init.gradle更直接有效
最常被忽略的是：Gradle wrapper 比全局 gradle 更可靠，也更易复现构建环境——别为了省事配 GRADLE_HOME，它反而容易和插件内置下载机制冲突。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
