Gradle任务不显示的根本原因是项目未被Java Language Server正确加载，需手动执行“Java: Import Projects”触发同步；多模块项目须在settings.gradle中声明include；中文乱码、报红等问题均源于Java版本、wrapper权限、仓库源三者未对齐。
Gradle任务不显示？先确认项目被Java Language Server加载
VSCode不会自动扫描build.gradle并注册任务，哪怕文件存在、插件已装，侧边栏没出现Gradle图标或任务面板显示“No tasks found”，就说明项目根本没被识别。这不是插件失效，而是构建上下文没加载进来。
- 右键点击
build.gradle→ 选择Link Gradle Project - 或按
Ctrl+Shift+P（Windows/Linux）/Cmd+Shift+P（macOS），输入并执行Java: Import Projects - 多模块项目必须检查
settings.gradle是否写了include 'module-name'，漏写一个，对应模块就完全不可见 - 终端运行
./gradlew tasks报错？说明wrapper本身有问题：可能是gradle/wrapper/gradle-wrapper.properties里distributionUrl被墙，或JDK版本低于Gradle要求（如Gradle 8.x需JDK 17+）
gradle run在终端能跑，VSCode里报Could not find or load main class
VSCode的gradle run任务不读application插件配置，也不继承gradle.properties或系统属性，它用的是插件自建的最小JVM上下文。
- 确保
build.gradle启用了application插件：plugins { id 'application' } - 显式声明主类：
application { mainClass = 'com.example.Main' }（注意不是mainClassName，那是旧版） - 不要依赖
gradle.properties里的systemProp.配置——VSCode任务不加载这些，改用applicationDefaultJvmArgs或直接在tasks.json里覆写 - 想临时换主类？得手动编辑
.vscode/tasks.json，加一个带args的自定义task，不能靠右键菜单切换
依赖标红但gradle build成功？这是classpath同步断裂
编译器“知道”依赖存在，但Java Language Server的索引没更新，导致补全失效、import报红、跳转失败——典型症状是gradle build成功，VSCode里满屏红线。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 按
Ctrl+Shift+P输入Java: Reload Project（不是Reload Window，后者无效） - 检查
.vscode/settings.json中是否设了"java.configuration.updateBuildConfiguration": "interactive"，应改为"automatic"才能实时响应build.gradle变更 - 国内用户务必在
build.gradle的repositories块里优先写阿里云镜像：maven { url 'https://maven.aliyun.com/repository/public' }，比改全局~/.gradle/init.gradle更直接有效 - Linux/macOS下
gradlew没执行权限？运行chmod +x gradlew，否则VSCode调不起wrapper
自定义task不出现？VSCode默认只认标准生命周期任务
你写了task deployToStaging，但它不会自动出现在“Tasks: Run Task”列表里。VSCode插件不自动发现所有task，必须显式声明。
立即学习“Java免费学习笔记（深入）”；
- 在项目根目录创建
.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版本对齐：终端java -version、gradle.properties里的org.gradle.java.home、VSCode设置里的java.home。差一个，就可能编译过但编辑器报红，或者gradle run启动失败。
