Android Studio 启动与 Gradle 插件故障排查

快速结论#

Android Studio 会把手动禁用的插件 ID 写入配置目录中的 disabled_plugins.txt。如果误禁用了启动依赖的插件，可先备份该文件，再删除对应插件 ID。

修复#

1. 完全退出 Android Studio。
2. 在 JetBrains/Android Studio 配置目录中找到 disabled_plugins.txt。
3. 复制一份备份，仅删除最近禁用的插件 ID。
4. 重新启动 IDE，并在插件设置中确认状态。

配置目录会随操作系统和 Android Studio 版本变化，应以官方目录说明为准。不要直接删除整个配置目录，否则会丢失更多本地设置。

快速结论#

如果错误中包含连接超时、代理拒绝连接或无法访问插件仓库，先检查用户级和项目级 gradle.properties 中是否残留代理。

# systemProp.http.proxyHost=127.0.0.1
# systemProp.http.proxyPort=7890
# systemProp.https.proxyHost=127.0.0.1
# systemProp.https.proxyPort=7890

只有在代理确实失效时才移除这些配置。企业网络可能必须使用代理，此时应修正地址和证书，而不是一律关闭。

继续排查#

确认 settings.gradle 或 settings.gradle.kts 的插件仓库包含项目需要的来源：

pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}