解决IntelliJ IDEA因残留旧模块导致Gradle同步失败的问题

修改项目移除模块后，同步Gradle时常会遇到IDEA仍尝试同步已删除模块的情况，最终导致同步失败，典型表现为IDEA提示找不到不存在的模块。

以下是解决步骤：

• 清理IDEA缓存：打开File → Invalidate Caches...，勾选Invalidate and Restart选项后重启IDEA，清除本地缓存的旧模块信息
• 检查Gradle配置：打开项目根目录的settings.gradle（或settings.gradle.kts），确认已移除旧模块的include语句，比如删除include ':old-module'这类配置行
• 删除IDEA本地模块配置：找到项目根目录的.idea文件夹，删除modules子目录中对应旧模块的.iml文件；同时打开.idea/modules.xml，移除其中关于旧模块的引用节点
• 重新同步项目：完成上述操作后，点击IDEA右上角的「Sync Project with Gradle Files」按钮，重新同步Gradle项目

内容的提问来源于stack exchange，提问作者Francisco Solis