必须手动启用Gradle插件并正确导入项目：先在Settings→Plugins中启用Gradle插件并重启IDEA，再通过Import Project选择Gradle构建类型，而非Open文件夹；同时确保Gradle JVM与wrapper版本匹配，并清除残留的.idea文件夹以重置项目识别状态。

IntelliJ IDEA安装后默认不自动启用Gradle支持，必须手动触发识别或配置，否则根本不会出现Gradle工具窗口、build.gradle高亮、右键菜单里的Reload project等关键能力。

Gradle插件是否已启用？

这是最常被跳过的一步。IDEA的Gradle支持由独立插件提供，新安装或重置后该插件常处于禁用状态。

• 打开 Settings → Plugins（macOS 是 Preferences → Plugins）
• 搜索 Gradle，确认官方插件状态为 Enabled（不是灰色禁用）
• 若刚启用，需重启IDEA才能生效——仅刷新不足够

项目是“打开”还是“导入”？

用 Open 打开含 build.gradle 的文件夹，IDEA会当作普通目录处理；必须用 Import Project 并主动选择 Gradle 构建类型，才能触发元数据解析。

• 关闭当前项目
• 选 File → New → Project from Existing Sources
• 定位到项目根目录，点击 OK 后，在弹出的构建工具选择页中，**明确勾选 Gradle**（不要选“Auto-detect”）
• 后续步骤中确保勾选 Use auto-import 和 Search for projects in subdirectories（多模块必需）

Gradle JVM与wrapper版本是否匹配？

IDEA用错JVM会导致Gradle窗口空白、Refresh按钮灰显，错误日志里常有 Unsupported class file major version 或静默失败。

Idea Spark

根据用户提供的领域或兴趣生成项目创意。当用户询问项目想法、寻求灵感、说“应该做什么项目”或“给我点想法”等时使用。

下载

• 检查 gradle/wrapper/gradle-wrapper.properties 中的 distributionUrl，例如 gradle-8.5-bin.zip
• 对照 Gradle官方兼容表，确认它要求的最低JDK版本（如Gradle 8.5需JDK 17+）
• 进入 Settings → Build → Build Tools → Gradle，将 Gradle JVM 改为匹配的JDK（不能是IDEA自带的bundled JRE）
• 若本地无合适JDK，需先安装JDK 17/21，再在IDEA中 Add JDK... 注册

为什么删掉 .idea 文件夹有时能解决？

因为IDEA把Gradle项目结构缓存在 .idea/misc.xml 和 .idea/modules.xml 里。一旦这些文件残留了错误的构建类型标记（比如之前误当成Maven打开过），后续所有操作都会沿用旧判断，连Reload都无效。

• 关掉项目
• 删除项目根目录下的整个 .idea 文件夹（不是隐藏属性问题，就是文件夹本身）
• 重新用 Import Project 流程导入，并**严格按前述步骤选Gradle**
• 不建议只删部分文件——缓存耦合紧密，删不干净反而更难排查

真正卡住的点往往不在Gradle本身，而在IDEA对“这是一个Gradle项目”的信任链：插件没开 → 不解析构建文件；用Open代替Import → 跳过解析入口；JVM错配 → 解析中途崩溃；缓存残留 → 解析结果被忽略。四个环节任一断裂，Gradle就彻底消失。