VSCode Gradle插件仅调度任务，需系统PATH或gradlew；自定义task须在tasks.json声明；Java版本需三处统一；中文乱码应配置gradle.properties的jvmargs。
Gradle插件装了但gradle命令找不到
VSCode 本身不自带 gradle，插件只是调度器，真正执行靠系统 PATH 里的 Gradle（或 wrapper）。常见现象是点击“Run Build Task”后报错：Command 'gradle' not found。
- 先在终端运行
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\...或直接删掉该配置，让插件自动探测
构建任务不触发build.gradle里的自定义task
VSCode 默认只识别标准生命周期任务（如 build、test），你写了 task deployToStaging，但它不会自动出现在“Tasks: Run Task”列表里。
- 必须在项目根目录加
.vscode/tasks.json，显式声明任务。示例：
{
"version": "2.0.0",
"tasks": [
{
"type": "gradle",
"name": "deployToStaging",
"gradleFile": "build.gradle",
"task": "deployToStaging",
"group": "build"
}
]
}
-
"type": "gradle"是关键，不是shell或process；否则插件不接管，也无法读取 Gradle 的依赖图和缓存 - 如果任务依赖其他 task（比如
dependsOn compileJava），不用额外写，Gradle 自己处理；但确保你在build.gradle里真用了dependsOn，而不是只写了doLast顺序调用——后者在 VSCode 任务中不会被感知
Java 版本不一致导致gradle build成功但 VSCode 报红
终端里 gradle build 成功，但 VSCode 编辑器里满屏红线，提示 java.lang.String 找不到，本质是 Java 编译环境没对齐。
- 检查三处 Java 版本是否统一：
java -version（JDK 运行时）、org.gradle.java.home（Gradle 配置的 JDK）、VSCode 的java.home设置（Java 扩展用） - Gradle wrapper 默认用
JAVA_HOME，但 VSCode Java 扩展默认读java.home；如果两者指向不同 JDK（比如一个是 JDK 17，一个是 JDK 21），就会出现编译通过但编辑器报错 - 最稳做法：在项目根目录建
gradle.properties，写死：org.gradle.java.home=/path/to/jdk-17；同时在 VSCode 设置里把java.home指向同一个路径
Build Task 输出中文乱码（尤其 Windows）
执行 gradle test 时控制台输出中文变成问号或方块，不是字体问题，是 Gradle JVM 启动参数没设编码。
立即学习“Java免费学习笔记（深入）”；
- 在项目根目录
gradle.properties中添加：org.gradle.jvmargs=-Dfile.encoding=UTF-8 - 别改
GRADLE_OPTS环境变量——VSCode 插件启动 Gradle 时不读它；也别在build.gradle里用compileJava.options.encoding = "UTF-8"，那只能管源码编译，不管控制台输出 - Windows 用户额外注意：CMD/PowerShell 默认代码页是 936（GBK），即使加了 JVM 参数，终端仍可能截断 UTF-8 输出；建议在 VSCode 设置里启用
terminal.integrated.defaultProfile.windows改为Git Bash或WSL，比硬调 CMD 更可靠
