rjgc/IDE-FIX-GUIDE.md

Android Studio 插件修复指南

问题原因

您的 Android Studio 右侧插件消失，通常是由于以下原因之一：

• .idea 目录损坏或配置不兼容
• Gradle 配置与新版 Android Studio 不匹配
• 缓存文件损坏
• 项目导入不完整

完整修复步骤

步骤1：运行自动修复脚本

1. 双击运行 fix-ide.bat 文件
2. 等待脚本执行完成
3. 脚本会自动清理损坏的配置文件

步骤2：在 Android Studio 中重新导入

1. File → Close Project 关闭当前项目
2. File → Open 重新选择项目目录： C:\Users\Administrator\AndroidStudioProjects\Notes-master
3. 等待 Gradle 同步完成（通常需要 2-5 分钟）

步骤3：验证插件恢复

同步完成后检查：

• 右侧工具窗口（Project、Structure、Gradle 等）应该正常显示
• File → Settings → Plugins 中应该能看到所有必要插件
• View → Tool Windows 菜单中应该有完整的工具窗口列表

手动检查要点

检查 Gradle 配置

• build.gradle：已更新为现代 plugins {} 语法
• app/build.gradle：已启用 viewBinding
• settings.gradle：使用正确的 pluginManagement

检查 AndroidManifest.xml

• 权限配置已更新为兼容 Android 13+
• 保留了向后兼容性

常见问题解决

如果仍然有问题：

1. 强制刷新 Gradle：点击 File → Sync Project with Gradle Files
2. 清除 Android Studio 缓存：File → Invalidate Caches and Restart → Invalidate and Restart
3. 检查 JDK 版本：确保使用 JDK 17 或 JDK 21（在 File → Project Structure → SDK Location 中检查）

预防措施

• 定期备份 .idea 目录
• 使用版本控制管理项目配置
• 避免手动编辑 .idea 目录中的文件

💡 提示：这个修复脚本是安全的，它只删除缓存和配置文件，不会影响您的源代码。

---

修复完成时间：2026年5月6日