插件安装失败90%是网络链路问题，非idea故障；改hosts文件映射最优ip或关闭“use secure connection”可快速解决超时；手动安装需核对插件与ide版本兼容性，并清理缓存、排除安全软件干扰。
插件安装失败，90% 是网络链路问题，不是 IDEA 本身坏了。 直接改 hosts 或关 secure connection 就能解决大部分超时；手动下载安装是兜底手段，但必须核对版本兼容性。
plugins.jetbrains.com 连接超时：改 hosts 是最快解法
IDEA 默认走 HTTPS 访问 plugins.jetbrains.com，但国内 DNS 解析常返回高延迟或不可达的海外节点 IP。日志里常见 Connection timed out 或 Remote host terminated the handshake，本质是 TCP 握手失败。
- 用浏览器打开
https://plugins.jetbrains.com，如果打不开，说明网络层已阻断 - 在命令行执行
nslookup plugins.jetbrains.com，看返回哪些 IP；再逐个ping -n 4 x.x.x.x（Windows）或ping -c 4 x.x.x.x（macOS/Linux），挑平均延迟最低、无丢包的那个 - 编辑
C:\Windows\System32\drivers\etc\hosts（Windows）或/etc/hosts（macOS/Linux），追加一行：13.225.117.9 plugins.jetbrains.com（示例 IP，替换成你测出的最优值） - 执行
ipconfig /flushdns（Windows）或sudo dscacheutil -flushcache（macOS），重启 IDEA
“Use secure connection” 导致 403/502 错误
某些企业防火墙或代理会拦截 HTTPS 请求并返回 403，而 IDEA 的插件市场又强制启用 Use secure connection 选项。关闭它后，IDEA 改用 HTTP 协议拉取插件列表，绕过 TLS 层拦截。
- 路径：
Settings → System Settings → Updates - 取消勾选
Use secure connection - 注意：该选项只影响插件市场访问，不影响插件本身运行安全
- 若仍失败，再检查
Settings → Appearance & Behavior → System Settings → HTTP Proxy是否启用了无效代理
手动安装插件：绕过网络，但必须验版本
当 hosts 和 proxy 都无效时，手动下载是最稳的 fallback 方式。但直接拖 ZIP 进去不等于成功——IDEA 会在加载时校验插件元数据与当前 IDE 版本是否匹配。
- 去
https://plugins.jetbrains.com搜索插件，点进详情页，注意右上角标注的Compatible with:，比如2023.2+ - 确认你 IDEA 的版本号：
Help → About，若显示2022.3.3，就别装标2023.2+的插件 - 下载后，在
Settings → Plugins → ⚙️ → Install Plugin from Disk选择 ZIP 文件 - 装完不要急着重启，先看
Settings → Plugins列表里该插件状态是否为 “Enabled”，灰色表示加载失败（常见于签名损坏或 JDK 不兼容）
安全软件和缓存干扰：容易被忽略的隐形杀手
360、腾讯电脑管家等常把 IDEA 插件下载行为识别为“可疑文件写入”，静默拦截；而缓存损坏则会让 IDEA 认为插件列表已失效，连 Marketplace 都不显示内容。
- 临时退出所有安全软件，再试一次自动安装；若成功，就把
idea64.exe和%LOCALAPPDATA%\JetBrains\IntelliJIdea*\plugins\加入白名单 - 清理插件缓存：
Settings → System Settings → Clear caches and restart，或手动删掉~/.cache/JetBrains/IntelliJIdea*/plugins/（Linux/macOS）或%LOCALAPPDATA%\JetBrains\IntelliJIdea*\plugins\（Windows） - 特别注意：某些插件（如
Codex）会在用户目录下写配置文件（如~/.codex/config.toml），残留旧配置会导致后续初始化失败，删掉再重装
真正卡住人的，往往不是技术多复杂，而是改了 hosts 忘 flushdns、下了 ZIP 忘看兼容版本、关了代理却没关安全软件——这些动作之间没有依赖关系，但漏掉任意一个，前面全白做。
