Android Studio 插件下载失败，界面卡在“Loading plugins…”或者干脆弹个“Cannot download plugin”的报错。这种场景，相信不少开发者都遇到过。

翻翻旧教程，十有八九会让你去设置里把“Use secure connection”勾掉。但坦白讲，这个方法在 2026 年的新版 AS 里已经彻底失效了，搞不好还会引发证书校验异常，越修越乱。

问题到底出在哪儿？其实根子往往不是什么网络开关的问题，而是几个容易被忽略的配置点。

下面按顺序走四步，基本都能解决。

第一步：确认插件仓库是否真正可达

打开 Android Studio → File → Settings → Plugins → 点击右上角的图标 → Manage Plugin Repositories。

这一步，重点看列表里是不是只剩一个默认地址 https://plugins.jetbrains.com。

如果列表被清空，或者地址显示为灰色不可用状态，说明仓库配置已经被破坏了。

点击 + 号手动添加：https://plugins.jetbrains.com。

注意：不要加尾部斜杠，也不要用 http（必须是 https）。

添加后点击 OK，等几秒，看看左下角有没有出现“Repository updated successfully”。

如果这里没有任何响应，那基本可以确定是本地的 hosts 文件或 DNS 劫持了该域名。这种情况比较棘手，需要单独排查网络环境。

第二步：清理残留插件缓存目录

关闭 Android Studio。

进入当前用户主目录，记得显示隐藏文件：

• Windows：按 Ctrl+H
• macOS：按 Cmd+Shift+.
• Linux：在文件管理器里勾选“显示隐藏文件”

找到并删除所有类似 .AndroidStudio2024.3、.AndroidStudio2024.1、.AndroidStudio2025.2 这样的文件夹。

注意：不是 .AndroidStudio 这个父目录，也不是 Android Studio 的安装目录本身，只是这些带版本号的缓存文件夹。

只保留你当前正在用的那个版本对应的文件夹。例如：

• 如果你用的是 Android Studio Giraffe | 2024.3.1，就只留 .AndroidStudio2024.3
• 如果是 Hedgehog | 2024.1.2，就留 .AndroidStudio2024.1

删掉其他旧版本的缓存，重启 AS，再试一下插件安装。

第三步：强制指定 Gradle JDK 并同步构建环境

这一步很容易被忽略，但它直接影响插件安装流程的底层通信能力。说的直白点：如果 Gradle JDK 选错了，HTTPS 握手可能直接失败。

操作路径：File → Project Structure → SDK Location → Gradle Settings → Gradle JDK。

在下拉菜单里选择“Android Studio default JDK”。这个选项的路径里通常包含 jbr 或 JetBrains Runtime 字样。

千万不要选系统环境变量里的 JAVA_HOME 或者自行安装的 JDK 17+ 路径。

点击 Apply，等到底部弹出“Project structure updated”提示，然后再点击右上角的 Sync Project with Gradle Files。

同步完成后，再回到 Plugins 页面尝试安装插件。此时插件下载请求会复用刚刚验证过的 Gradle 运行时通道，绕开部分 HTTPS 握手失败的情况。

第四步：手动安装插件包（离线可用）

如果以上三步都试过了还是不行，那就直接走离线安装方案——最稳妥。

方法一：从官网直接下载 ZIP 包

访问 https://plugins.jetbrains.com/，搜索你需要的插件。

点击进入详情页 → 点击 “Version History” → 找到与你当前 AS 版本兼容的最新 release → 点击 “Download”（得到 xxx.zip 文件）。

然后回到 AS 里：Settings → Plugins → → Install Plugin from Disk → 选中刚下载的 ZIP 文件 → 重启 IDE。

方法二：复用已有插件目录（适合团队快速分发）

找一台能正常安装插件的机器，定位到该插件解压后的文件夹。路径类似 .AndroidStudio2024.1/config/plugins/idea-markdown。

把整个文件夹打包成 ZIP → 复制到另一台有问题的机器上，解压到相同的 config/plugins 目录下 → 重启 AS 即可识别。

注意小坑：插件文件夹名必须与插件 ID 完全一致，大小写敏感，不能自行重命名。

《夸克》非常好用的免费AI浏览器

下载APP查看